Skip to content
CAI
Software that uses CAICheck a score

symfony/filesystem

53.8

Adequate · 17 November 2026

1.5k

lines of production code

PHP

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Behavioural changes

Filesystem component receives major API modernization and new Path utility

The Filesystem component introduces a new Path class for cross-platform path manipulation and significantly modernizes the Filesystem API. Methods like copy(), mkdir(), touch(), and remove() now enforce strict type hints, throw specific exceptions instead of returning booleans, and preserve file permissions and modification times during copy operations. The component also adds new capabilities such as the readFile() method, stream-aware tempnam(), and the ability to append to files with locking. Additionally, legacy behaviors are deprecated or removed, including the removal of array support in dumpFile(), the deprecation of the copy\_on\_windows mirror option in favor of follow\_symlinks, and the removal of the LockHandler class.

(repo-wide) · high confidence

Introduce Filesystem-specific exception classes implementing •Throwable

The Filesystem component now provides a dedicated hierarchy of exception classes (IOException, FileNotFoundException, InvalidArgumentException, RuntimeException) that implement the new ExceptionInterface, which extends PHP's native \\Throwable. This allows users to catch filesystem errors using standard PHP exception handling while accessing specific details like the file path via the getPath() method on IOException.

Exception · high confidence

Test coverage

Added MockStream fixture for testing stream wrappers; Initial test suite for the Filesystem component.

Dependencies

Symfony Filesystem package initialization with PHP 8.4+ requirement

The symfony/filesystem package has been added to the project, providing basic filesystem utilities. This package requires PHP 8.4.1 or higher and includes dependencies on symfony/deprecation-contracts (^2.5\|^3), symfony/polyfill-ctype (\~1.8), and symfony/polyfill-mbstring (\~1.8). Development dependencies include symfony/process (^7.4\|^8.0). The package uses PSR-4 autoloading and excludes test files from the classmap.

(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.9 → 53.8 (-0.1)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 65.8 → 65.3 (-0.5)
  • Architecture 100.0 → 100.0 (0.0)
  • Maturity 42.4 → 42.4 (0.0)
  • Readiness 46.8 → 46.8 (0.0)
  • Security 100.0 → 100.0 (0.0)

Resolved (1)

  • Duplicated block (10 lines × 2) (Filesystem.php)

New (2)

  • Edited copy of a member (14 corresponding lines) (Filesystem.php)
  • Edited copy of a member (5 corresponding lines) (Filesystem.php)

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/filesystem 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 17 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 fc51d765e5283576c9d94637ddd120a2ead37842 — 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.85+preprod-eba6548ac50f.