finder

This library is no longer supported or maintained as PHP 5.2 usage levels have finally dropped below 10%

Fork of Symfony's Finder component compatible with PHP 5.2+.

Motivation

Symfony's Finder component is a fantastic library, but it's only compatible with PHP 5.3+. While 99% of PHP servers run PHP 5.2 or higher, 13% of all servers are still running PHP 5.2 or lower (source).

Differences from Symfony's Finder component

The primary difference is naming conventions of the Symfony classes. Instead of the \Symfony\Component\Finder namespace (and sub-namespaces), prefix the Symfony class names with ehough_finder and follow the PEAR naming convention

A few examples of class naming conversions:

\Symfony\Component\Finder\Finder                  ----->    ehough_finder_Finder
\Symfony\Component\Finder\Expression\Expression   ----->    ehough_finder_expression_Expression
\Symfony\Component\Finder\Shell\Command           ----->    ehough_finder_shell_Command

Usage

Finder finds files and directories via an intuitive fluent interface.

$finder = new ehough_finder_Finder();

$iterator = $finder
  ->files()
  ->name('*.php')
  ->depth(0)
  ->size('>= 1K')
  ->in(__DIR__);

foreach ($iterator as $file) {
    print $file->getRealpath()."\n";
}

But you can also use it to find files stored remotely like in this example where we are looking for files on Amazon S3:

$s3 = new Zend_Service_Amazon_S3($key, $secret);
$s3->registerStreamWrapper("s3");

$finder = new ehough_finder_Finder();
$finder->name('photos*')->size('< 100K')->date('since 1 hour ago');
foreach ($finder->in('s3://bucket-name') as $file) {
    print $file->getFilename()."\n";
}

Releases and Versioning

Releases are synchronized with the upstream Symfony repository. e.g. ehough/finder v2.3.1 has merged the code from Symfony/Finder v2.3.1.