File: ezcFile
[ ]
[ ]
[ ]
[ ]
[ ]
Class: ezcFile
|
Provides a selection of static independent methods to provide functionality for file and file system handling. [
source]
This example shows how to use the findRecursive method:
1. <?php
2. // lists all the files under /etc (including subdirectories) that end in
3. // .conf
4. $confFiles = ezcFile::findRecursive( "/etc", array( '@\.conf$@' ) );
5.
6. // lists all autoload files in the components source tree and excludes the
7. // ones in the autoload subdirectory.
8. $files = ezcFile::findRecursive(
9. "/dat/dev/ezcomponents",
10. array( '@src/.*_autoload.php$@' ),
11. array( '@/autoload/@' )
12. );
13.
14. // lists all binaries in /bin except the ones starting with a "g"
15. $data = ezcFile::findRecursive( "/bin", array(), array( '@^/bin/g@' ) );
16. ?>
Method Summary
|
public static string |
calculateRelativePath(
$path, $base )
Calculates the relative path of the file/directory '$path' to a given $base path. |
|
public static array |
findRecursive(
$sourceDir, [$includeFilters = array()], [$excludeFilters = array()], $excludeFilters
)
Finds files recursively on a file system |
|
public static void |
removeRecursive(
$directory )
Removes files and directories recursively from a file system |
Methods
calculateRelativePath
string calculateRelativePath(
string
$path, string
$base )
Calculates the relative path of the file/directory '$path' to a given $base path.
This method does not touch the filesystem.
Parameters
| Name |
Type |
Description |
$path |
string |
|
$base |
string |
|
findRecursive
array findRecursive(
string
$sourceDir, [
$includeFilters = array()], [
$excludeFilters = array()], array(string)
$excludeFilters
)
Finds files recursively on a file system
With this method you can scan the file system for files. You can use $includeFilters to include only specific files, and $excludeFilters to exclude certain files from being returned. The function will always go into subdirectories even if the entry would not have passed the filters.
Parameters
| Name |
Type |
Description |
$sourceDir |
string |
|
$includeFilters |
array(string) |
|
$excludeFilters
|
array(string) |
|
$excludeFilters |
array |
|
Throws
| Class | Description |
|---|
ezcBaseFileNotFoundException |
if the $sourceDir directory is not a directory or does not exist. |
ezcBaseFilePermissionException |
if the $sourceDir directory could not be opened for reading. |
removeRecursive
void removeRecursive(
string
$directory )
Removes files and directories recursively from a file system
This method recursively removes the $directory and all its contents. You should be extremely careful with this method as it has the potential to erase everything that the current user has access to.
Parameters
| Name |
Type |
Description |
$directory |
string |
|
Last updated: Thu, 01 Nov 2007
