internal/promise

A lightweight implementation of CommonJS Promises/A for PHP

2.12.0 2025-08-26 19:17 UTC

Requires

• php: >=8.1

Requires (Dev)

• buggregator/trap: ^1.13
• phpunit/phpunit: ^10.5.10
• rector/rector: ^2.1
• spiral/code-style: ^2.2
• ta-tikoma/phpunit-architecture-test: ^0.8.5
• vimeo/psalm: ^6.13

Replaces

• react/promise: ^2.0

MIT

• Jan Sorgalla
• Christian Lück
• Cees-Jan Kiewiet
• Chris Boden

• promises
• promise

README

A lightweight implementation of CommonJS Promises/A for PHP.

Note

This is a fork of reactphp/promise with the following improvements:

• PHP 8.1+ compatibility
• declare(strict_types=1); in all files
• @yield annotations in promise interfaces
• Enhanced type annotations
• Replaces react/promise v2

Install

The recommended way to install this library is through Composer.

composer require internal/promise

Credits

This fork is based on reactphp/promise, which is a port of when.js by Brian Cavalier.

Also, large parts of the documentation have been ported from the when.js [Wiki][Wiki] and the [API docs][API docs].