Skip to content
CAI
Software that uses CAICheck a score

symfony/finder

53.4

Adequate · 13 November 2026

2.4k

lines of production code

PHP

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.