Fast File Utility Extension (with Pure PHP Implementation Support)
FileUtil Extension provides an efficient way to operate file related operations.
Install the PHP extension:
git clone https://github.com/c9s/php-fileutil.git
cd php-fileutil
phpize
./configure
make
make install
phpbrew ext enable fileutil # if you use phpbrew
Install the pure PHP implementation:
$ pear channel-discover pear.corneltek.com
$ pear install corneltek/FileUtil
$filelist = futil_scanpath("/etc");
$dirlist = futil_scanpath_dir("/etc");
$path = futil_pathjoin("etc","folder","file1");
// which returns "etc/folder/file1", as the same as "etc" . DIRECTORY_SEPARATOR . "folder" . DIRECTORY_SEPARATOR . "file1"
$subpaths = futil_pathsplit("etc/folder/file1");
// replace current extension with another extension.
$newFilename = futil_replace_extension("manifest.yml","json"); // Returns manifest.json
// get extension from the filename.
$extension = futil_get_extension("manifest.yml"); // Returns "yml"
// copy file if the mtime of source is newer than the mtime of destination.
futil_copy_if_newer("source_file","target_file");
// copy file if destination does not exist.
futil_copy_if_not_exists("source_file", "target_file");
// prepend path to an array that contains paths.
$filelist = array(
"file1",
"file2",
"path2/file3",
"path3/file4",
"path4/file5",
);
futil_paths_prepend($filelist, "/root");
/* $filelist = array(
"/root/file1",
"/root/file2",
"/root/path2/file3",
"/root/path3/file4",
"/root/path4/file5",
);
*/
// clean up whole directory
if ( false === futil_rmtree("/path/to/delete") ) {
}
$newfilename = futil_filename_append_suffix("Picture.png", "_suffix"); // Returns "Picture_suffix.png"
$newfilename = futil_filename_append_suffix("Picture", "_suffix"); // Returns "Picture_suffix"
$content = futil_get_contents_from_files(array("file1","file2","file3"));
$contents = futil_get_contents_array_from_files(array("config.m4","php_fileutil.c"));
foreach( $contents as $content ) {
echo $content['path'];
echo $content['content'];
}
$dirs = futil_paths_filter_dir($allfiles);
$files = futil_paths_filter_files($allfiles);
The behavior is different from the built-in function scandir($dir)
,
futil_scanpath
concat the items with the base path, and it filters out "." and
".." paths.
$list = futil_scanpath('/etc');
/*
array(
'/etc/af.plist',
'/etc/afpovertcp.cfg',
'/etc/asl.conf',
);
*/
As the same as futil_scanpath($dir)
, but futil_scanpath_dir
only returns directory entries.
This returns the last modification time from a filelist array.
This returns the last creation time from a filelist array.
Recursively delete files and directories through RecursiveDirectoryIterator.
-
Fork this project.
-
Clone the git repository.
-
Run commands under the repository:
pear channel-discover pear.corneltek.com pear channel-update -f corneltek pear install -f corneltek/Universal pear install -f corneltek/PHPUnit_TestMore pear install -f corneltek/PHPUnit_Framework_ExtensionTestCase pear install -f corneltek/ExtUnit phpize ./configure make
-
Run extunit to test extension functions:
extunit --phpunit
-
Run phpunit to test pure php functions:
phpunit
Pedro cornelius.howl@gmail.com
See LICENSE file.