library finder

ehough/finder

Fork of Symfony's Finder Component compatible with PHP 5.2+

finder

, _(*1)

Fork of Symfony's Finder component compatible with PHP 5.2+., _(*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)., _(*3)

Once PHP 5.3+ adoption levels break 90%, this library will be retired., _(*4)

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, _(*5)

A few examples of class naming conversions:, _(*6)

\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., _(*7)

$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:, _(*8)

$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., _(*9)