symfony/process
53.6
Adequate · 13 November 2026
3.1k
lines of production code
PHP
primary language
7
measurements over time
What this system is
Features
Add Messenger integration for running background processes
The Messenger component now includes support for executing system processes asynchronously via the new \RunProcessMessage\, \RunProcessMessageHandler\, and \RunProcessContext\ classes. Users can dispatch a \RunProcessMessage\ (constructed with a command array or via \fromShellCommandline\) to queue a process execution; the handler runs the process and returns a \RunProcessContext\ containing the exit code, output, and error output, or throws a \RunProcessFailedException\ if the process fails.
Messenger · high confidence
Added Process Bundle configuration for messenger integration
The Resources/config/process.php file has been added to register the RunProcessMessageHandler service within the dependency injection container. This configuration automatically tags the handler with 'messenger.message\_handler', enabling the Symfony Process component to integrate with the Messenger component for asynchronous process execution.
Resources · high confidence
Symfony Process component v8.2 release
This release introduces the ProcessBundle for easier integration, adds the PhpSubprocess class to run PHP commands while preserving the parent's php.ini settings, and provides the RunProcessMessage and RunProcessMessageHandler for asynchronous process execution via the Messenger component. It also adds the fromShellCommandline factory method to RunProcessMessage, the setIgnoredSignals method to the Process class to disable signal propagation, and the getStartTime method to retrieve the process start time.
(repo-wide) · high confidence
Behavioural changes
Process component exceptions now implement Throwable and expose process details
The Process component's exception hierarchy has been refactored so that all exceptions (including ProcessFailedException, ProcessSignaledException, ProcessStartFailedException, ProcessTimedOutException, and RunProcessFailedException) implement the new ExceptionInterface which extends PHP's native Throwable. This allows catching all process-related errors with a single try-catch block. Additionally, ProcessFailedException now includes the working directory, exit code, and output/error streams in its message, and all exception classes provide a getProcess() method to access the underlying Process instance for further inspection.
Exception · high confidence
Refactored Process Pipes to use modern PHP types and constructor property promotion
The Pipes component has been updated to use modern PHP 8.1+ features, including constructor property promotion, native type declarations, and union types. This refactoring improves code clarity and maintainability for the internal pipe implementations (AbstractPipes, UnixPipes, WindowsPipes) without changing the external behavior of process execution.
Pipes · high confidence
Test coverage
Added test coverage for Symfony Process component; Added tests for RunProcessMessageHandler.
Dependencies
Symfony Process component requires PHP 8.4.1+
The Symfony Process component now requires PHP 8.4.1 or higher. This update also aligns development dependencies with Symfony 7.4 and 8.1, and enforces a conflict with Symfony Dependency Injection versions prior to 8.1 to ensure compatibility.
(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 54 → 54 (-0.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 66 → 66 (-0.3)
- Architecture 99 → 100 (+0.7)
- Maturity 43 → 43 (-0.0)
- Readiness 47 → 47 (+0.0)
- Security 95 → 95 (+0.0)
Resolved (2)
- Change coupling: UnixPipes.php ↔ WindowsPipes.php (Pipes/UnixPipes.php)
- Documentation: no installation or build instructions (README.md)
New (2)
- Edited copy of a member (19 corresponding lines) (PhpProcess.php)
- Skipped (documented): testForkDoesNotRemoveTheScriptOfPhpdbg (Tests/PhpProcessTest.php)
Changes since last survey
- 5 commits — 5 feature/other, 0 fixes
By area
- (repo) — 3 commits
- (root) — 2 commits
Notable commits
- change: Merge branch '6.4' into 7.4
- change: Merge branch '7.4' into 8.1
- change: Merge branch '8.1' into 8.2
- change: [Process] Keep the script of PhpProcess when a forked child exits under phpdbg
- change: [Process] Poll with short sleeps first when waiting for a process whose pipes are closed
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/process 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 c9fb4cfeb0fe4b6fdacd0113b46fd54eaa04835f — 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.