PHPackages guzzlehttp/promises - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [HTTP & Networking](/categories/http) 4. / 5. guzzlehttp/promises ActiveLibrary[HTTP & Networking](/categories/http) guzzlehttp/promises =================== Guzzle promises library 3.0.0(4w ago)7.7k1.0B↓10.4%128[2 issues](https://github.com/guzzle/promises/issues)20MITPHPPHP ^7.4 || ^8.0CI passing Since Apr 18Pushed 1w ago32 watchersCompare [ Source](https://github.com/guzzle/promises)[ Packagist](https://packagist.org/packages/guzzlehttp/promises)[ GitHub Sponsors](https://github.com/GrahamCampbell)[ GitHub Sponsors](https://github.com/Nyholm)[ RSS](/packages/guzzlehttp-promises/feed)WikiDiscussions 3.0 Synced 2w ago READMEChangelog (10)Dependencies (9)Versions (72)Used By (20) Guzzle Promises =============== [](#guzzle-promises) `guzzlehttp/promises` is a small promise library used by Guzzle for asynchronous operations. It implements promise chaining, synchronous waiting, cancellation, and helpers for working with groups of promises. Most application developers use this package through [`guzzlehttp/guzzle`](https://github.com/guzzle/guzzle/blob/8.0/README.md) by calling methods such as `requestAsync()`. Install this package directly when you need promise composition without the full HTTP client. Installation ------------ [](#installation) ``` composer require guzzlehttp/promises ``` Version Guidance ---------------- [](#version-guidance) VersionStatusPHP Version3.0Latest>=7.4,<8.62.5Maintenance>=7.2.5,<8.61.5End of Life>=5.5,<8.3Quick Start ----------- [](#quick-start) ``` use GuzzleHttp\Promise\Promise; use GuzzleHttp\Promise\Utils; $promise = new Promise(); $promise->then( function ($value) { echo 'Fulfilled: ' . $value; }, function ($reason) { echo 'Rejected: ' . $reason; } ); $promise->resolve('done'); Utils::queue()->run(); ``` You can wait for a promise to complete synchronously: ``` $value = $promise->wait(); ``` When using Guzzle HTTP requests, asynchronous methods return `GuzzleHttp\Promise\PromiseInterface` instances: ``` $promise = $client->requestAsync('GET', 'https://example.com'); $response = $promise->wait(); ``` Documentation ------------- [](#documentation) - [Promise Quick Start](docs/promise-quick-start.md) - [Promise API](docs/promise-api.md) - [Promise Interoperability](docs/promise-interoperability.md) - [Implementation Notes](docs/implementation-notes.md) - [Upgrade Guide](UPGRADING.md) - [Changelog](CHANGELOG.md) Security -------- [](#security) If you discover a security vulnerability within this package, please send an email to . All security vulnerabilities will be promptly addressed. Please do not disclose security-related issues publicly until a fix has been announced. Please see [Security Policy](https://github.com/guzzle/promises/security/policy) for more information. License ------- [](#license) Guzzle is made available under the MIT License (MIT). Please see [License File](LICENSE) for more information. For Enterprise -------------- [](#for-enterprise) Available as part of the Tidelift Subscription The maintainers of Guzzle and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/packagist-guzzlehttp-promises?utm_source=packagist-guzzlehttp-promises&utm_medium=referral&utm_campaign=enterprise&utm_term=repo) ### Health Score 84 — ExcellentBetter than 100% of packages Maintenance96 Actively maintained with recent releases Popularity86 Widely adopted with strong download metrics Community59 Growing community involvement Maturity83 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~108 days Recently: every ~12 days Total 39 Last Release 28d ago Major Versions 0.1.2 → 1.0.02015-05-13 1.5.3 → 2.0.02023-05-21 2.5.1 → 3.0.x-dev2026-07-20 PHP version history (5 changes)0.1.0PHP >=5.4.0 0.1.2PHP >=5.5.0 1.4.0PHP >=5.5 2.0.0PHP ^7.2.5 || ^8.0 3.0.x-devPHP ^7.4 || ^8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/190930?v=4)[Michael Dowling](/maintainers/mtdowling)[@mtdowling](https://github.com/mtdowling) ![](https://www.gravatar.com/avatar/401ccc5eea13c60cf807ae982af00e368e2166e2f26d8eb541dcd881a57385bc?d=identicon)[Nyholm](/maintainers/Nyholm) ![](https://www.gravatar.com/avatar/0e4e105cea62b616d4cb376b08a849b6a428f646998537de150d16a8eb537b90?d=identicon)[mark.sagikazar](/maintainers/mark.sagikazar) ![](https://www.gravatar.com/avatar/d95eb26cb8f3919bb5ca3b6d823daeabbf259663778a970349b245c580713c8e?d=identicon)[graham-campbell](/maintainers/graham-campbell) --- Top Contributors [![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (126 commits)")[![mtdowling](https://avatars.githubusercontent.com/u/190930?v=4)](https://github.com/mtdowling "mtdowling (106 commits)")[![Tobion](https://avatars.githubusercontent.com/u/610090?v=4)](https://github.com/Tobion "Tobion (15 commits)")[![sagikazarmark](https://avatars.githubusercontent.com/u/1226384?v=4)](https://github.com/sagikazarmark "sagikazarmark (11 commits)")[![jeskew](https://avatars.githubusercontent.com/u/705500?v=4)](https://github.com/jeskew "jeskew (9 commits)")[![joshdifabio](https://avatars.githubusercontent.com/u/5609851?v=4)](https://github.com/joshdifabio "joshdifabio (8 commits)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (7 commits)")[![alexeyshockov](https://avatars.githubusercontent.com/u/203120?v=4)](https://github.com/alexeyshockov "alexeyshockov (3 commits)")[![gmponos](https://avatars.githubusercontent.com/u/5675248?v=4)](https://github.com/gmponos "gmponos (3 commits)")[![villfa](https://avatars.githubusercontent.com/u/2891564?v=4)](https://github.com/villfa "villfa (3 commits)")[![jeremeamia](https://avatars.githubusercontent.com/u/107867?v=4)](https://github.com/jeremeamia "jeremeamia (2 commits)")[![andont](https://avatars.githubusercontent.com/u/3939123?v=4)](https://github.com/andont "andont (2 commits)")[![mcfedr](https://avatars.githubusercontent.com/u/704356?v=4)](https://github.com/mcfedr "mcfedr (2 commits)")[![bpolaszek](https://avatars.githubusercontent.com/u/5569077?v=4)](https://github.com/bpolaszek "bpolaszek (2 commits)")[![edipoReboucas](https://avatars.githubusercontent.com/u/974859?v=4)](https://github.com/edipoReboucas "edipoReboucas (1 commits)")[![kicken](https://avatars.githubusercontent.com/u/6234547?v=4)](https://github.com/kicken "kicken (1 commits)")[![madelson](https://avatars.githubusercontent.com/u/1269046?v=4)](https://github.com/madelson "madelson (1 commits)")[![ntzm](https://avatars.githubusercontent.com/u/3888578?v=4)](https://github.com/ntzm "ntzm (1 commits)")[![baileylo](https://avatars.githubusercontent.com/u/145345?v=4)](https://github.com/baileylo "baileylo (1 commits)")[![reedy](https://avatars.githubusercontent.com/u/67615?v=4)](https://github.com/reedy "reedy (1 commits)") --- Tags promise ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/guzzlehttp-promises/health.svg) ``` [![Health](https://phpackages.com/badges/guzzlehttp-promises/health.svg)](https://phpackages.com/packages/guzzlehttp-promises) ``` ### Alternatives [symfony/routing Maps an HTTP request to a set of configuration variables 7.6k851.5M2.9k](/packages/symfony-routing)[api-platform/core Build a fully-featured hypermedia or GraphQL API in minutes! 2.6k52.2M377](/packages/api-platform-core)[zircote/swagger-php Generate interactive documentation for your RESTful API using PHP attributes (preferred) or PHPDoc annotations 5.3k148.6M671](/packages/zircote-swagger-php)[symfony/http-foundation Defines an object-oriented layer for the HTTP specification 8.7k950.4M7.2k](/packages/symfony-http-foundation)[symfony/dependency-injection Allows you to standardize and centralize the way objects are constructed in your application 4.2k464.3M10.6k](/packages/symfony-dependency-injection)[symfony/http-kernel Provides a structured process for converting a Request into a Response 8.1k886.6M9.7k](/packages/symfony-http-kernel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)