symfony/finder
53.4
Adequate · 13 November 2026
2.4k
lines of production code
PHP
primary language
7
measurements over time
What this system is
Behavioural changes
Comparator class made immutable with added operator support and stricter validation
The Comparator classes in the Finder component are now immutable, with target and operator values set via constructor arguments instead of mutable setters. The base Comparator class now explicitly supports the '!=' (not equal) operator, which was previously missing from the default comparison logic. Validation is stricter: invalid operators throw an exception immediately upon construction, and DateComparator uses DateTimeImmutable for more robust date parsing. NumberComparator now accepts null as a valid test string and validates numeric inputs more rigorously.
Comparator · high confidence
Finder component modernized with native types, fluent API, and .gitignore support
The Finder component has been significantly refactored for modern PHP (8.1+), introducing native type declarations, private properties, and a fluent static \Finder::create()\ factory method. The API now supports chaining multiple depth/date/exclude rules via arrays, allows combining multiple search paths with \Finder::append()\, and enables sorting by extension, size, or case-insensitive name. New filtering capabilities include ignoring \.gitignore\ patterns (\ignoreVCSIgnored\), forcing forward slashes on Windows (\useUnixPaths\), and root-relative excludes. The component also adds \SplFileInfo\ extensions for relative paths and file content, and includes a new \Gitignore\ class to parse gitignore files into regex patterns.
(repo-wide) · high confidence
Finder iterators refactored with modern PHP features and new filtering capabilities
The Iterator component has been significantly modernized and expanded. Several iterators (FilenameFilterIterator, PathFilterIterator, FilecontentFilterIterator) now extend a new MultiplePcreFilterIterator base class, unifying pattern matching logic. New iterators include FilecontentFilterIterator for filtering by file contents and LazyIterator for deferred execution. The ExcludeDirectoryFilterIterator now supports callable prune filters and root-relative directory excludes. The SortableIterator has been expanded with new sorting options (extension, size, access/changed/modified time, natural/case-insensitive sorting) and a reverse order flag. The IgnoreVcsFilterIterator was removed and replaced by VcsIgnoredFilterIterator, which supports nested .gitignore files and looks for .git directories up to the git root. Code quality improvements include strict typing, modern PHP syntax (arrow functions, short arrays), and updated copyright headers.
Iterator · high confidence
New Finder exception classes for access and directory errors
The Finder component now includes dedicated exception classes to improve error handling clarity. AccessDeniedException (extending UnexpectedValueException) is introduced to signal access-denied scenarios, while DirectoryNotFoundException (extending InvalidArgumentException) is added to specifically indicate when a requested directory cannot be found. These changes allow users to catch and handle these specific failure modes more precisely than relying on generic exceptions.
Exception · high confidence
Test coverage
Added comprehensive test coverage for Symfony Finder component; Added test fixtures for path-based finder tests; Added unit tests for Finder Comparator classes; Added unit tests for Finder Iterator components.
Dependencies
Symfony Finder requires PHP 8.4.1 and Symfony 7.4/8.0
The Symfony Finder component now mandates a minimum PHP version of 8.4.1, reflecting a significant upgrade from previous versions. Additionally, the development dependencies have been updated to require symfony/filesystem version ^7.4 or ^8.0, ensuring compatibility with the latest Symfony ecosystem releases. The package configuration also enforces PSR-4 autoloading and excludes test files from the classmap to optimize performance.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 53 → 53 (-0.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 64 → 64 (-0.2)
- Architecture 100 → 100 (+0.0)
- Maturity 42 → 42 (-0.1)
- Readiness 47 → 47 (+0.0)
- Security 100 → 100 (+0.0)
Resolved (3)
- Documentation: no installation or build instructions (README.md)
- Documentation: no usage examples (README.md)
- Off-boarding risk: anonymized user #1
New (2)
- Edited copy of a member (13 corresponding lines) (Iterator/DateRangeFilterIterator.php)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 12 commits — 9 feature/other, 3 fixes
By area
- (repo) — 9 commits
- (root) — 3 commits
Notable commits
- fix: [Finder] Fix Glob::toRegex() producing an invalid regex for bracket expressions containing a slash
- fix: [Finder] Fix Glob::toRegex() when the delimiter is a slash
- fix: [Finder] Fix three bracket expressions Glob::toRegex() gets wrong
- change: Merge branch '6.4' into 7.4
- change: Merge branch '6.4' into 7.4
- change: Merge branch '6.4' into 7.4
- change: Merge branch '7.4' into 8.1
- change: Merge branch '7.4' into 8.1
- change: Merge branch '7.4' into 8.1
- change: Merge branch '8.1' into 8.2
- change: Merge branch '8.1' into 8.2
- change: Merge branch '8.1' into 8.2
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
symfony/finder was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit ec42ab967ff3ae1c12861a073b60189e11755e36 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-859b6d22580d.