symfony/filesystem
53.8
Adequate · 17 November 2026
1.5k
lines of production code
PHP
primary language
5
measurements over time
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.