A major new feature release, see release announcement.

• We'd like to emphasize that this component is production ready and battle-tested. We plan to support all long-term support (LTS) releases for at least 24 months, so you have a rock-solid foundation to build on top of.

• The v4 release will be the way forward for this package. However, we will still actively support v3 and v2 to provide a smooth upgrade path for those not yet on PHP 8.1+. If you're using an older PHP version, you may use either version which all provide a compatible API but may not take advantage of newer language features. You may target multiple versions at the same time to support a wider range of PHP versions:

  • 4.x branch (PHP 8.1+)
  • 3.x branch (PHP 7.1+)
  • 2.x branch (PHP 5.3+)

This update involves some major new features and a minor BC break over the v2.0.0 release. We've tried hard to avoid BC breaks where possible and minimize impact otherwise. We expect that most consumers of this package will be affected by BC breaks, but updating should take no longer than a few minutes. See below for more details:

• Feature / BC break: Require PHP 7.1+ and add type declarations. (#11 by @clue)

• Feature: Add Generator-based coroutine() function. (#12, #13 and #54 by @clue)

• Feature: Support iterable type for parallel() + series() + waterfall(). (#45 by @clue)

The following changes had to be ported to this release due to our branching strategy, but also appeared in the v2.0.0 release:

• Feature: Only stop loop for await() if a pending promise resolves/rejects. (#33 by @SimonFrings)

• Feature: Forward compatibility with upcoming Promise v3. (#47 by @clue)

• Minor documentation improvements. (#37 by @SimonFrings and #52 by @nhedger)