Apache Zeta Components - high quality PHP components

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 = ezcBaseFile::findRecursive( "/etc", array( '@\.conf$@' ) );
5.  
6.  // lists all autoload files in the components source tree and excludes the
7.  // ones in the autoload subdirectory. Statistics are returned in the $stats
8.  // variable which is passed by reference.
9.  $files = ezcBaseFile::findRecursive(
10.      "/dat/dev/ezcomponents",
11.      array( '@src/.*_autoload.php$@' ),
12.      array( '@/autoload/@' ),
13.      $stats
14.  );
15.  
16.  // lists all binaries in /bin except the ones starting with a "g"
17.  $data = ezcBaseFile::findRecursive( "/bin", array(), array( '@^/bin/g@' ) );
18.  ?>

$path and $base should be fully absolute paths. This function returns the answer of "How do I go from $base to $path". If the $path and $base are the same path, the function returns '.'. This method does not touch the filesystem.

Recursively copy a file or directory in $source to the given destination. If a depth is given, the operation will stop, if the given recursion depth is reached. A depth of -1 means no limit, while a depth of 0 means, that only the current file or directory will be copied, without any recursion.

You may optionally define modes used to create files and directories.

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. It uses the {@see walkRecursive()} method to do the actually recursion.

Filters are regular expressions and are therefore required to have starting and ending delimiters. The Perl Compatible syntax is used as regular expression language.

If you pass an empty array to the $statistics argument, the function will in details about the number of files found into the 'count' array element, and the total filesize in the 'size' array element. Because this argument is passed by reference, you *have* to pass a variable and you can not pass a constant value such as "array()".

This callback method works together with walkRecursive() and is called for every file/and or directory. The $context is a callback specific container in which data can be stored and shared between the different calls to the callback function. The walkRecursive() function also passes in the full absolute directory in $sourceDir, the filename in $fileName and file information (such as size, modes, types) as an array as returned by PHP's stat() in the $fileInfo parameter.

With the $os parameter you can tell this function to use the semantics for a different operating system to determine whether a path is absolute. The $os argument defaults to the OS that the script is running on.

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.

This method walks over a directory and calls a callback from every file and directory it finds. 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.

The callback is passed in the $callback parameter, and the $callbackContext will be send to the callback function/method as parameter so that you can store data in there that persists with all the calls and recursive calls to this method. It's up to the callback method to do something useful with this. The callback function's parameters are in order:

• ezcBaseFileFindContext $context
• string $sourceDir
• string $fileName
• array(stat) $fileInfo

See {@see findRecursiveCallback()} for an example of a callback function.

Filters are regular expressions and are therefore required to have starting and ending delimiters. The Perl Compatible syntax is used as regular expression language.