README.md
1Finder Component
2================
3
4Finder finds files and directories via an intuitive fluent interface.
5
6 use Symfony\Component\Finder\Finder;
7
8 $finder = new Finder();
9
10 $iterator = $finder
11 ->files()
12 ->name('*.php')
13 ->depth(0)
14 ->size('>= 1K')
15 ->in(__DIR__);
16
17 foreach ($iterator as $file) {
18 print $file->getRealpath()."\n";
19 }
20
21But you can also use it to find files stored remotely like in this example where
22we are looking for files on Amazon S3:
23
24 $s3 = new \Zend_Service_Amazon_S3($key, $secret);
25 $s3->registerStreamWrapper("s3");
26
27 $finder = new Finder();
28 $finder->name('photos*')->size('< 100K')->date('since 1 hour ago');
29 foreach ($finder->in('s3://bucket-name') as $file) {
30 print $file->getFilename()."\n";
31 }
32
33Resources
34---------
35
36You can run the unit tests with the following command:
37
38 $ cd path/to/Symfony/Component/Finder/
39 $ composer.phar install
40 $ phpunit
41
42