symfony/process

This system is the Symfony Process component, a library for executing external system commands and managing background processes. It provides core capabilities for synchronous and asynchronous execution via the Messenger component, including support for PHP subprocesses and signal handling. The implementation has been modernized to require PHP 8.4.1+ and features a refactored exception hierarchy for improved error handling and debugging.

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

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

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

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

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

Added test coverage for Symfony Process component; Added tests for RunProcessMessageHandler.

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 watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 47 → 56 (+9.2)
• Rubric changed (rubric-2026.08.15 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 97 → 91 (-5.9)
• Architecture 94 → 96 (+1.7)
• Maturity 43 → 43 (-0.4)
• Readiness 24 → 43 (+18.6)
• Security 88 → 95 (+7.1)

• Coverage not measured — test suite did not build
• Dimension evaluation failed
• Duplicated block (6 lines × 2) (Tests/ProcessFailedExceptionTest.php)
• High: security finding (details withheld)
• No exposed public API
• No tests found
• No usage example showing how to instantiate or call Process::execute(). (README.md)
• Only one sponsor link; the README's own backer is not claimed. (README.md)
• Test reliability not included

• AbstractPipes.write (cognitive 57) (Pipes/AbstractPipes.php)
• AbstractPipes.write (cyclomatic 27) (Pipes/AbstractPipes.php)
• Change coupling: UnixPipes.php ↔ WindowsPipes.php (Pipes/UnixPipes.php)
• ClassTooLong: Process (Process.php)
• Documentation: no installation or build instructions (README.md)
• Documentation: no usage examples (README.md)
• ExecutableFinder.find (cognitive 32) (ExecutableFinder.php)
• ExecutableFinder.find (cyclomatic 24) (ExecutableFinder.php)
• FileTooLong: ./Process.php (Process.php)
• Hotspot: Process.php (Process.php)
• No assertions: testOptionCreateNewConsole (Tests/CreateNewConsoleTest.php)
• PhpExecutableFinder.find (cognitive 23) (PhpExecutableFinder.php)
• PhpExecutableFinder.find (cyclomatic 20) (PhpExecutableFinder.php)
• Process.doSignal (cognitive 20) (Process.php)
• Process.getIterator (cognitive 29) (Process.php)
• Process.start (cognitive 30) (Process.php)
• Process.start (cyclomatic 27) (Process.php)
• Process.waitUntil (cognitive 19) (Process.php)
• Skipped (documented): testExitCodeCommandFailed (Tests/ProcessTest.php)
• Skipped (documented): testFind (Tests/ExecutableFinderTest.php)
• …and 29 more

• 19 commits — 18 feature/other, 1 fixes

• (repo) — 11 commits
• (root) — 6 commits
• Pipes/AbstractPipes.php — 1 commit
• Tests/ProcessTest.php — 1 commit

• fix: bug #65739 [Process] Ignore invalid env var names and non-scalar env values (nicolas-grekas, dionisvl)
• change: Merge branch '5.4' into 6.4
• 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 '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 '7.4' into 8.1
• change: Merge branch '8.1' into 8.2
• change: [Process] Do not wait for output when the input iterator has more data
• change: [Process] Ignore array env values before proc_open
• change: [Process] Ignore invalid env var names
• change: [Process] Remove outdated LogicException PHPDoc
• change: [Process] Stop leaking CGI/FastCGI request-context vars to subprocesses
• change: [Process] Use an absolute path for the cmd.exe fallback on Windows
• change: [Process] Widen the timing bound of testIteratorInputDoesNotWaitForOutput
• change: [Process][FrameworkBundle] Add ProcessBundle

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

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.