Documentation

Learn how to use TrueAsync for building concurrent PHP applications.

Future::getAwaitingInfo

(PHP 8.6+, True Async 1.0)

public function getAwaitingInfo(): array

Returns debug information about coroutines that are currently awaiting the completion of this Future. Useful for diagnosing deadlocks and analyzing dependencies between coroutines.

Return value

array — an array with information about awaiting coroutines.

Examples

Example #1 Getting information about waiters

<?php

use Async\Future;
use Async\FutureState;

$state = new FutureState();
$future = new Future($state);

// Launch several coroutines awaiting one Future
\Async\async(function() use ($future) {
    $future->await();
});

\Async\async(function() use ($future) {
    $future->await();
});

// Give coroutines time to start waiting
\Async\delay(10);

$info = $future->getAwaitingInfo();
var_dump($info);
// Array with information about awaiting coroutines

$state->complete("done");

See also