NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #16 most downloaded on Packagist
Guzzle promises library
Latest stable
3.2.0
Last release today
21 Nov 2026
Release timing varies
gaps range from 2 weeks to 9 months
Nearly every release is documented
notes for 39 of 42 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
42 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Changed Coroutine to forward cancellation from chained promises
Coroutine to forward cancellation from chained promisesTaskQueue to remove tasks in constant timeFixed LogicException when a callback settles its own promise
LogicException when a callback settles its own promiseFixed Promise losing its handlers when a thenable's then() throws
Promise losing its handlers when a thenable's then() throwsCreate::promiseFor() throwing when a thenable's then() throwsUtils::inspect() losing the outcome of a chained promiseYour coding agent can read these notes before it upgrades. Set up the MCP server →
Deprecated Is because PHP 8.6 deprecates is as a class name
State promise state checks as a replacement for IsIs because PHP 8.6 deprecates is as a class nameAdded Added support for PHP 8.6
Changed the default TReason of FulfilledPromise and Create::promiseFor() to never
TReason of FulfilledPromise and Create::promiseFor() to neverTValue of RejectedPromise and Create::rejectionFor() to neverEachPromise abandoning its aggregate when the pending window drains unsettledEachPromise admitting new work after its aggregate has settledAdded concurrency config support to Utils::all() and Each::of()
concurrency config support to Utils::all() and Each::of()concurrency config support to Utils::settle()Utils::inspect() to return actual rejection reasonsUtils::inspect() to prefer the settled state over late wait function exceptionsEachPromiseIteratorAggregate inputs to collection helpers instead of treating them as a single valueUtils::all() handling of dynamically-added settled values and raw valuesFixed LogicException when a callback settles its own promise
LogicException when a callback settles its own promiseFixed Promise losing its handlers when a thenable's then() throws
Promise losing its handlers when a thenable's then() throwsCreate::promiseFor() throwing when a thenable's then() throwsDeprecated Is because PHP 8.6 deprecates is as a class name
State promise state checks as a replacement for IsIs because PHP 8.6 deprecates is as a class nameAdded Added support for PHP 8.6
Fixed EachPromise abandoning its aggregate when the pending window drains unsettled
EachPromise abandoning its aggregate when the pending window drains unsettledEachPromise admitting new work after its aggregate has settledFixed recursive Utils::all() rejecting generator inputs
Utils::all() rejecting generator inputsDeprecated passing non-iterable inputs to promise collection helpers and EachPromise
EachPromiseFixed cancelling settled coroutines when no current promise remains
Empty EachPromise instances now resolve when the task queue runs without wait()
EachPromise instances now resolve when the task queue runs without wait()Fixed Utils::inspect() returning the internal reason array instead of the AggregateException
Utils::inspect() returning the internal reason array instead of the AggregateException### Added - PHP 8.5 support
Revert "Allow an empty EachPromise to be resolved by running the queue"
Allow an empty EachPromise to be resolved by running the queue
Once settled, don't allow further rejection of additional promises
### Changed - PHP 8.4 support
Replaced call_user_func* with native calls
call_user_func* with native callsSee change log for changes.
See change log for changes.
See change log for changes.
GuzzleHttp\Promise namespaceSee change log for changes.
See change log for changes.
See change log for changes.
See change log for changes.
See change log for changes.
See change log for changes.
See change log for changes.
See change log for changes.
Utils::taskSee change log for changes.
See change log for changes.
See change log for changes.
See change log for changes.
$recursive flag to alleach processingmethod_exists crashes on PHP 8Fixed wait() foreign promise compatibility
Adds support for custom task queues.
Update to now catch \Throwable on PHP 7+
\Throwable on PHP 7+Update EachPromise to prevent recurring on a iterator when advancing, as this could trigger fatal generator errors.
Update EachPromise to immediately resolve when the underlying promise iterator is empty. Previously, such a promise would throw an exception when its
wait
function was called.Conditionally require functions.php.
Updating EachPromise to call next on the underlying promise iterator as late as possible to ensure that generators that generate new requests based on
- Initial release
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.