NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #308 most downloaded on Packagist
A fiber-aware process manager based on Amp and Revolt.
Latest stable
v2.1.2
Last release 15 days ago
07 Nov 2026
Release timing varies
gaps range from 2 weeks to 1.5 years
Nearly every release is documented
notes for 29 of 31 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
38 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Don't let the wrapper shell's job notification block kill() by @danog in #88
Full Changelog: v2.1.1...v2.1.2
Full Changelog: https://github.com/amphp/process/compare/v2.1.1...v2.1.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Mark the command of Process::start() as a Psalm shell taint sink by @danog in https://github.com/amphp/process/pull/87
Full Changelog: https://github.com/amphp/process/compare/v2.1.0...v2.1.1
Full Changelog: v2.1.0...v2.1.1
Added getSignalName() function which returns the signal constant name, if defined, from a signal number. Requires ext-pcntl, otherwise null is always
getSignalName() function which returns the signal constant name, if defined, from a signal number. Requires ext-pcntl, otherwise null is always returned.Full Changelog: https://github.com/amphp/process/compare/v2.0.3...v2.1.0
getSignalName() function which returns the signal constant name, if defined, from a signal number. Requires ext-pcntl, otherwise null is always returned.Full Changelog: v2.0.3...v2.1.0
Make implicit nullable types explicit to avoid deprecation notice in PHP 8.4.
Full Changelog: https://github.com/amphp/process/compare/v2.0.2...v2.0.3
Full Changelog: v2.0.2...v2.0.3
Changed waiting for children during shutdown to be synchronous to ensure all children are properly cleaned up. This should avoid zombie processes left
UnhandledFutureError being thrown to event loop if reading the process exit code fails.Full Changelog: https://github.com/amphp/process/compare/v2.0.1...v2.0.2
UnhandledFutureError being thrown to event loop if reading the process exit code fails.Full Changelog: v2.0.1...v2.0.2
Fixed error handling if the started process fails immediately.
Full Changelog: https://github.com/amphp/process/compare/v2.0.0...v2.0.1
Full Changelog: v2.0.0...v2.0.1
Stable release compatible with AMPHP v3 and fibers! 🎉
Stable release compatible with AMPHP v3 and fibers! 🎉
As with other libraries compatible with AMPHP v3, most cases of parameters or returns of Promise<ResolutionType> have been replaced with ResolutionType.
Process::__construct() is now private in favor of Process::start()Process::start() is now static instead of an instance methodProcess::start()no longer returns the PID, use Process::getPid()Process::kill() no longer causes an exception to be thrown from Process::join()Process::getEnv() has been renamed to Process::getEnvironment()Process object is destructed, but the process streams (STDIN, STDOUT, STDERR) are still usedescapeArguments to escapeArgumentStatusErrorProcess::getWorkingDirectory()join() inside kill() to avoid suspensions in destructorsCancellation parameter to Process::join()ext-pcntl, an optional dependency)Add compatibility with Revolt v1.x
Added an optional Cancellation parameter to Process::join().
Cancellation parameter to Process::join().Fixed shutdown behavior, which could cause an InvalidCallbackError
InvalidCallbackErrorRemoved check for ext-pcntl, which is not strictly required for this library.
ext-pcntl, which is not strictly required for this library.ext-pcntl)Add compatibility with revolt/event-loop 0.2.x
amphp/syncrevolt/event-loop 0.2.xFull Changelog: https://github.com/amphp/process/compare/v2.0.0-beta.2...v2.0.0-beta.3
Fixed and improved wrapper copy if running inside of PHARs on Windows
Process::getWorkingDirectory()amphp/byte-stream v2.0.0-beta.2join() inside kill() to avoid suspensions in destructorsProcess::__construct() is now private in favor of Process::start()
Process::__construct() is now private in favor of Process::start()Process::start() is now static instead of an instance methodProcess::start() does no longer return the PID, use Process::getPid()Process::kill() does no longer result in an exception of Process::join()Process::getEnv() has been renamed to Process::getEnvironment()escapeArguments to escapeArgumentStatusErrorFixed potential hang on Windows when a process crashes introduced in 1.1.8.
Full Changelog: https://github.com/amphp/process/compare/v1.1.8...v1.1.9
Full Changelog: v1.1.8...v1.1.9
Fixed potential exception on Windows if a process crashes.
Full Changelog: https://github.com/amphp/process/compare/v1.1.7...v1.1.8
Full Changelog: v1.1.7...v1.1.8
Fix loop getting stuck when launching a process fails on Windows by @MatmaRex in https://github.com/amphp/process/pull/72
Full Changelog: https://github.com/amphp/process/compare/v1.1.6...v1.1.7
Make implicit nullable types explicit by @nicolas-grekas in https://github.com/amphp/process/pull/73
Full Changelog: https://github.com/amphp/process/compare/v1.1.5...v1.1.6
Full Changelog: v1.1.5...v1.1.6
Fix posix_kill crashing / killing other programs on null by @gerardroche in https://github.com/amphp/process/pull/68
posix_kill crashing / killing other programs on null by @gerardroche in https://github.com/amphp/process/pull/68Full Changelog: https://github.com/amphp/process/compare/v1.1.4...v1.1.5
posix_kill crashing / killing other programs on null by @gerardroche in #68Full Changelog: v1.1.4...v1.1.5
Fixed ended processes sometimes leaving zombie processes on *nix systems (requires ext-pcntl, an optional dependency)
ext-pcntl, an optional dependency)Fixed wrapper path if running inside PHARs on Windows
ProcessException being thrown if process killing fails on Windows, which has been subject to race conditionsAdded a work-around for a bug with preloading and conditionally declared functions
Fixed socket TypeError on PHP 8
TypeError on PHP 8taskkill on windows for Process::kill()Added escapeArguments() function that escapes process arguments for each platform (i.e., Windows vs. Linux/Unix)
escapeArguments() function that escapes process arguments for each platform (i.e., Windows vs. Linux/Unix) (#35)v1.2 (#34)Process::signal() sending signals to the wrapper child process instead of the intended child (#36)Process::join() resolving before the child process exits due to termination signals being sent and handled or ignored by the child process (#36)Fixed killing unresponsive processes.
Fixed hanging on Windows if the child process is killed.
Fixed issue on Windows when calling Process::getStdin(), Process::getStdout(), or Process::getStderr() immediately after the process has started.
Process::getStdin(), Process::getStdout(), or Process::getStderr() immediately after the process has started.This release introduces a couple of backwards-compatibility breaks that will require some small adjustments to code using this library.
This release introduces a couple of backwards-compatibility breaks that will require some small adjustments to code using this library.
Process::start() now returns a promise. This promise must resolve before calling Process::getPid(), Process::getStdin(), Process::getStdout(), and Process::getStderr() otherwise an exception is thrown from these methods.Process::getPid() now returns an integer.Process, ProcessInputStream, and ProcessOutputStream are now final.Fixed starting processes inside PHARs on Windows.
Deferred double resolution in case of an error.Fixed timing issues on streams.
Fixed issues on Windows if a process is killed during startup.
Only some minor API breaks were necessary:
Windows support added!
Only some minor API breaks were necessary:
Process::getPid() now returns a promise for the PID.Process::getStdIn() returns an instance of ProcessInputStream instead of ResourceInputStream, however the same API is shared by both classes.Process::getStdOut() and Process::getStdErr() both return an instance of ProcessOutputStream instead of ResourceOutputStream, however the same API is shared by both classes.Changed return types of Process::getStd*() functions to be more specific. By specifying ResourceInputStream and ResourceOutputStream, methods such as
Process::getStd*() functions to be more specific. By specifying ResourceInputStream and ResourceOutputStream, methods such as close() or unreference() can reliably be used.API has changed dramatically. Please see the documentation.
Initial release for Amp v2.0.
API has changed dramatically. Please see the documentation.
Process::__construct accepts an array of arguments now to build the command
Process::__construct accepts an array of arguments now to build the commandNothing published for this version
Nothing published for this version
First release with stable dependencies.
First release with stable dependencies.
One column per quarter.