Loheide-eu-mitarbeiterplatt.../vendor/guzzlehttp/promises/docs/promise-interoperability.md
Friederich Loheide 9c0f8de791
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m14s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m12s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m7s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m19s
CI / PHP 8.3 / mysql:8.0 (pull_request) Successful in 1m32s
CI / PHP 8.4 / mysql:8.0 (pull_request) Successful in 1m22s
CI / PHP 8.4 / mysql:8.4 (pull_request) Successful in 1m32s
CI / PHP 8.3 / mysql:8.4 (pull_request) Successful in 1m35s
CI / Build-Artefakte aktuell (pull_request) Failing after 1m7s
Phase 0: Fundament für Inhaus
- Laravel 13 mit Filament 5 (Admin), Inertia 3 + Vue 3 + Vuetify 4 (Material 3)
- Anmeldung über Fortify (Login, Passwort vergessen/ändern), keine Selbstregistrierung
- Profil mit Profilbild (WebP in festen Größen), Personenseiten, Header mit Avatar-Menü
- Material-3-Farbschema aus der Primärfarbe, hell/dunkel/System pro Person
- Basis-Branding (Portalname, Logo, Primärfarbe) im Admin unter „Erscheinungsbild“
- Benutzerverwaltung im Admin, Zugang vorläufig über is_admin
- vendor/ (ohne Dev-Pakete) und Frontend-Build mitversioniert, Dev-Pakete in vendor-dev/
- PHPUnit-Tests gegen MySQL/MariaDB, Forgejo-CI-Matrix, Docker-Entwicklungsumgebung
- VERSION, CHANGELOG.md und CONTRIBUTING.md mit Release-Ablauf

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-25 20:35:30 +00:00

2.6 KiB

Promise Interoperability

This guide explains how Guzzle promises interact with foreign promise implementations. A foreign promise is any object with a then method, such as a React promise. When a foreign promise is returned from a then callback, Guzzle forwards resolution to that promise.

Foreign Promises

Capture the promise returned from then(). That chained promise is the Guzzle promise that follows the foreign promise's eventual result.

use GuzzleHttp\Promise\Promise;
use GuzzleHttp\Promise\Utils;

$deferred = new React\Promise\Deferred();
$reactPromise = $deferred->promise();

$guzzlePromise = new Promise();
$chained = $guzzlePromise->then(function ($value) use ($reactPromise) {
    // Use the Guzzle value, then continue with the React promise.
    return $reactPromise;
});

$chained->then(function ($value) {
    echo $value;
});

$guzzlePromise->resolve('start');
Utils::queue()->run();

$deferred->resolve('done');
Utils::queue()->run();

Forwarding a foreign promise does not make Guzzle able to synchronously wait on or cancel the foreign operation. The chained Guzzle promise settles only after the foreign implementation invokes the callbacks registered through then(). If the foreign promise has no compatible wait() or cancel() behavior, Guzzle cannot invent that behavior.

Use Create::promiseFor($foreignPromise) to shadow a foreign thenable as a Guzzle promise. If the foreign object exposes wait() or cancel() methods, the wrapper uses them. Otherwise, use the foreign implementation's event loop or completion mechanism and drain Guzzle's task queue when callbacks need to run.

Event Loop Integration

Guzzle promises use a task queue to keep stack size constant and to run promise callbacks asynchronously. When waiting on promises synchronously, the task queue is automatically run while resolving the blocking promise and forwarded Guzzle promises.

When using promises asynchronously in an event loop, run the task queue on loop ticks. If you do not run the task queue, Guzzle promise callbacks may remain queued.

$queue = GuzzleHttp\Promise\Utils::queue();
$queue->run();

For example, you could use Guzzle promises with React using a short periodic timer. Avoid zero-interval timers because they may keep the loop busy even when there is no promise work to run.

$queue = GuzzleHttp\Promise\Utils::queue();
$loop = React\EventLoop\Factory::create();
$loop->addPeriodicTimer(0.01, [$queue, 'run']);