Skip to content
CAI
Software that uses CAICheck a score

symfony/process

53.6

Adequate · 13 November 2026

3.1k

lines of production code

PHP

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.