Replace aggregation and waiting methods on Utils with focused APIs
Author: GrahamCampbellCreated Jul 16, 2026Updated Aug 5, 2026
Labelsenhancement
Utils currently combines global queue access, synchronous waiting, and promise aggregation. We will separate the waiting and aggregation APIs while leaving the global queue alone.
- Replace
Utils::all(),Utils::some(),Utils::any(), andUtils::settle()with the same methods onAggregate. - Replace
Utils::inspect(),Utils::inspectAll(), andUtils::unwrap()with the same methods onAwait. - Keep
Utils::queue()andUtils::task()onUtils. Moving the global queue is unnecessary and risks changing queue identity or scheduling behavior.
The old aggregation and waiting methods will become exact PHPDoc-deprecated delegates in 3.1, without runtime warnings, and will be removed in 4.0. Ordering, concurrency, recursion, rejection, cancellation, inspection, and global queue behavior will remain unchanged.
Source: guzzle/promises