2.9.0 (2022-02-11)
Feature: Support union types and address deprecation of ReflectionType::getClass()
(PHP 8+).
(#198 by @cdosoftei and @SimonFrings)
$promise->otherwise(function (OverflowException|UnderflowException $e) {
echo 'Error: ' . $e->getMessage() . PHP_EOL;
});
Feature: Support intersection types (PHP 8.1+). (#195 by @bzikarsky)
$promise->otherwise(function (OverflowException&CacheException $e) {
echo 'Error: ' . $e->getMessage() . PHP_EOL;
});
Improve test suite, use GitHub actions for continuous integration (CI), update to PHPUnit 9, and add full core team to the license. (#174, #183, #186, and #201 by @SimonFrings and #211 by @clue)
2.8.0 (2020-05-12)
Mark FulfilledPromise
, RejectedPromise
and LazyPromise
as deprecated for Promise v2 (and remove for Promise v3).
(#143 and #165 by @clue)
// deprecated
$fulfilled = new React\Promise\FulfilledPromise($value);
$rejected = new React\Promise\RejectedPromise($reason);
// recommended alternatives
$fulfilled = React\Promise\resolve($value);
$rejected = React\Promise\reject($reason);
Fix: Fix checking whether cancellable promise is an object and avoid possible warning. (#168 by @smscr and @jsor)
Improve documentation and add docblocks to functions and interfaces. (#135 by @CharlotteDunois)
Add .gitattributes
to exclude dev files from exports.
(#154 by @reedy)
Improve test suite, run tests on PHP 7.4 and update PHPUnit test setup. (#163 by @clue)
2.7.1 (2018-01-07)
2.7.0 (2018-06-13)
2.6.0 (2018-06-11)
Feature: Significantly improve memory consumption and performance by only passing resolver args to resolver and canceller if callback requires them. Also use static callbacks without binding to promise, clean up canceller function reference when they are no longer needed and hide resolver and canceller references from call stack on PHP 7+. (#113, #115, #116, #117, #118, #119 and #123 by @clue)
These changes combined mean that rejecting promises with an Exception
should
no longer cause any internal circular references which could cause some unexpected
memory growth in previous versions. By explicitly avoiding and explicitly
cleaning up said references, we can avoid relying on PHP’s circular garbage collector
to kick in which significantly improves performance when rejecting many promises.
Mark legacy progress support / notification API as deprecated (#112 by @clue)
Recommend rejecting promises by throwing an exception (#114 by @jsor)
Improve documentation to properly instantiate LazyPromise (#121 by @holtkamp)
Follower cancellation propagation was originally planned for this release but has been reverted for now and is planned for a future release. (#99 by @jsor and #122 by @clue)
2.5.1 (2017-03-25)
2.5.0 (2016-12-22)
42d86b7
(PR #36, released
in v2.3.0) and
was both unintended and backward incompatible.If you need automatic cancellation, you can use something like:
function allAndCancel(array $promises)
{
return \React\Promise\all($promises)
->always(function() use ($promises) {
foreach ($promises as $promise) {
if ($promise instanceof \React\Promise\CancellablePromiseInterface) {
$promise->cancel();
}
}
});
}
2.4.1 (2016-05-03)
some()
not cancelling pending promises when too much input promises
reject (16ff799
).2.4.0 (2016-03-31)
2.3.0 (2016-03-24)
\Throwable
in the same way as \Exception
(#51 by @joshdifabio).2.2.2 (2016-02-26)
2.2.1 (2015-07-03)
2.2.0 (2014-12-30)
ExtendedPromiseInterface
implemented by all promises.done()
method (part of the ExtendedPromiseInterface
).otherwise()
method (part of the ExtendedPromiseInterface
).always()
method (part of the ExtendedPromiseInterface
).progress()
method (part of the ExtendedPromiseInterface
).Deferred::progress
to Deferred::notify
to avoid confusion with
ExtendedPromiseInterface::progress
(a Deferred::progress
alias is
still available for backward compatibility)resolve()
now always returns a ExtendedPromiseInterface
.2.1.0 (2014-10-15)
CancellablePromiseInterface
implemented by all promises.cancel()
method (part of the CancellablePromiseInterface
).2.0.0 (2013-12-10)
New major release. The goal is to streamline the API and to make it more compliant with other promise libraries and especially with the new upcoming ES6 promises specification.
race()
function.ResolverInterface
and PromiseInterface
from
Deferred
.PromiseInterface
.When
and Util
classes and move static methods to
functions.FulfilledPromise
and RejectedPromise
now throw an exception
when initialized with a promise instead of a value/reason.Deferred::resolve()
and Deferred::reject()
no longer return
a promise.