PHPackages                             ehough/finder - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. ehough/finder

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

ehough/finder
=============

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

v2.8.0(10y ago)37961MITPHPPHP &gt;=5.2

Since Jul 16Pushed 9y ago1 watchersCompare

[ Source](https://github.com/ehough/finder)[ Packagist](https://packagist.org/packages/ehough/finder)[ RSS](/packages/ehough-finder/feed)WikiDiscussions develop Synced today

READMEChangelog (10)Dependencies (2)Versions (36)Used By (0)

finder
------

[](#finder)

[![Build Status](https://camo.githubusercontent.com/d35b001484bdbc056f130fbf40429a6af4b85d22a38b37f58f0738449c174acc/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f65686f7567682f66696e6465722e706e67)](http://travis-ci.org/ehough/finder)[![Project Status: Unsupported - The project has reached a stable, usable state but the author(s) have ceased all work on it. A new maintainer may be desired.](https://camo.githubusercontent.com/baae56ff2a4e564adcf10fe13a639b7e4aaf1d62054fd5086a2e570ecc3637e5/687474703a2f2f7777772e7265706f7374617475732e6f72672f6261646765732f6c61746573742f756e737570706f727465642e737667)](http://www.repostatus.org/#unsupported)[![Latest Stable Version](https://camo.githubusercontent.com/eac09e8b25a4e538cf3062399dad3a7818fec8c634ea9f08965b71194d7d5307/68747470733a2f2f706f7365722e707567782e6f72672f65686f7567682f66696e6465722f762f737461626c65)](https://packagist.org/packages/ehough/finder)[![License](https://camo.githubusercontent.com/7c35560651d07b2196b57438e81bc811b00fb89ed96e11d0ae0b037d7c50605d/68747470733a2f2f706f7365722e707567782e6f72672f65686f7567682f66696e6465722f6c6963656e7365)](https://packagist.org/packages/ehough/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](https://github.com/symfony/Finder) compatible with PHP 5.2+.

### Motivation

[](#motivation)

[Symfony's Finder component](https://github.com/symfony/Finder) 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](http://w3techs.com/technologies/details/pl-php/5/all)).

### Differences from [Symfony's Finder component](https://github.com/symfony/Finder)

[](#differences-from-symfonys-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](http://pear.php.net/manual/en/standards.php)

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

[](#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-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`.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~26 days

Recently: every ~0 days

Total

34

Last Release

3863d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/53b269d929f6ba572a15e4b069d9b59e0e99af74db1be60cbac7a56adfea9221?d=identicon)[ehough](/maintainers/ehough)

---

Top Contributors

[![fabpot](https://avatars.githubusercontent.com/u/47313?v=4)](https://github.com/fabpot "fabpot (266 commits)")[![ehough](https://avatars.githubusercontent.com/u/369261?v=4)](https://github.com/ehough "ehough (166 commits)")[![nicolas-grekas](https://avatars.githubusercontent.com/u/243674?v=4)](https://github.com/nicolas-grekas "nicolas-grekas (36 commits)")[![jfsimon](https://avatars.githubusercontent.com/u/119407?v=4)](https://github.com/jfsimon "jfsimon (16 commits)")[![gajdaw](https://avatars.githubusercontent.com/u/676675?v=4)](https://github.com/gajdaw "gajdaw (10 commits)")[![Tobion](https://avatars.githubusercontent.com/u/610090?v=4)](https://github.com/Tobion "Tobion (10 commits)")[![vicb](https://avatars.githubusercontent.com/u/248818?v=4)](https://github.com/vicb "vicb (8 commits)")[![pborreli](https://avatars.githubusercontent.com/u/77759?v=4)](https://github.com/pborreli "pborreli (7 commits)")[![Seldaek](https://avatars.githubusercontent.com/u/183678?v=4)](https://github.com/Seldaek "Seldaek (6 commits)")[![jakzal](https://avatars.githubusercontent.com/u/190447?v=4)](https://github.com/jakzal "jakzal (5 commits)")[![stof](https://avatars.githubusercontent.com/u/439401?v=4)](https://github.com/stof "stof (5 commits)")[![kalessil](https://avatars.githubusercontent.com/u/1577185?v=4)](https://github.com/kalessil "kalessil (4 commits)")[![xabbuh](https://avatars.githubusercontent.com/u/1957048?v=4)](https://github.com/xabbuh "xabbuh (4 commits)")[![alquerci](https://avatars.githubusercontent.com/u/2987860?v=4)](https://github.com/alquerci "alquerci (3 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (3 commits)")[![keradus](https://avatars.githubusercontent.com/u/2716794?v=4)](https://github.com/keradus "keradus (3 commits)")[![webmozart](https://avatars.githubusercontent.com/u/176399?v=4)](https://github.com/webmozart "webmozart (3 commits)")[![igorw](https://avatars.githubusercontent.com/u/88061?v=4)](https://github.com/igorw "igorw (2 commits)")[![pcampr](https://avatars.githubusercontent.com/u/289776?v=4)](https://github.com/pcampr "pcampr (2 commits)")[![romainneutron](https://avatars.githubusercontent.com/u/137574?v=4)](https://github.com/romainneutron "romainneutron (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ehough-finder/health.svg)

```
[![Health](https://phpackages.com/badges/ehough-finder/health.svg)](https://phpackages.com/packages/ehough-finder)
```

###  Alternatives

[rewieer/taskschedulerbundle

Task Scheduler with CRON for Symfony

63247.9k](/packages/rewieer-taskschedulerbundle)[yieldstudio/nova-google-autocomplete

A Laravel Nova Google autocomplete field.

12233.3k](/packages/yieldstudio-nova-google-autocomplete)[tacowordpress/tacowordpress

WordPress custom post types that feel like CRUD models

232.2k](/packages/tacowordpress-tacowordpress)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
