10quality/wp-file

Small class library that facilitates file handling in WordPress.

v1.0.0 2023-01-05 15:59 UTC

This package is auto-updated.

Last update: 2024-11-05 19:48:16 UTC


README

Latest Stable Version Total Downloads License

This small class library facilitates file handling for WordPress custom developments, will provide all functionality to meet WordPress' standards.

Features:

  • Theme Check ready.
  • Easy to use.

Installation

With composer

Make the dependecy required in your project:

composer require 10quality/wp-file

Alternative

Download or clone the project and load the class with php functions:

require_once '[PATH TO CLASS]/File.php';

Usage

The following example will let you see how to use the class:

Code to replace

$filename = __DIR__.'/myfile.txt';

$file = @fopen( $filename, ,'w+' );

$content = fread( $file );

fwrite( $file, $content );

fclose($file);

Replacement:

use TenQuality\WP\File;

$filename = __DIR__.'/myfile.txt';

$content = File::auth()->read( $filename );

File::auth()->write( $filename, $content );

Authentication

WordPress will require to authenticate a url in order to validate if filesystem credentials are in place.

If you need to authenticate a specific url, pass it like this:

File::auth( $url )->read( $filename );

Other methods

// Returns bool
$isFile = File::auth()->is_file( $filename );
// Returns bool
$fileExists = File::auth()->exists( $filename );

Folder or Path handling

Methods to handle files:

$file = File::auth();

// Use is_dir to check if a path exists or not.
if ( $file->is_dir( $path ) )
    // Use mkdir to create non-existent paths.
    $file->mkdir( $path );
// Use rmdir to remove paths.
$file->rmdir( $path );

Recomendations

Store your files in the uploads folder.

Coding guidelines

PSR-4.

LICENSE

The MIT License (MIT)

Copyright (c) 2016 10Quality.