Документация

Узнайте, как использовать TrueAsync для создания конкурентных PHP-приложений.

TaskGroup::awaitCompletion

(PHP 8.6+, True Async 1.0)

public TaskGroup::awaitCompletion(): void

Ждёт, пока все задачи в группе полностью завершатся. В отличие от all(), не возвращает результаты и не бросает исключений при ошибках задач.

Группа должна быть запечатана перед вызовом.

Типичный сценарий — дождаться реального завершения корутин после cancel(). Метод cancel() инициирует отмену, но корутины могут завершаться асинхронно. awaitCompletion() гарантирует, что все корутины остановлены.

Ошибки

Бросает Async\AsyncException, если группа не запечатана.

Примеры

Пример #1 Ожидание после cancel

<?php

use Async\TaskGroup;
use function Async\suspend;

spawn(function() {
    $group = new TaskGroup();

    $group->spawn(function() {
        suspend();
        return "result";
    });

    $group->cancel();
    $group->awaitCompletion();

    echo "все корутины завершены\n";
    var_dump($group->isFinished()); // bool(true)
});

Пример #2 Получение результатов после ожидания

<?php

use Async\TaskGroup;

spawn(function() {
    $group = new TaskGroup();

    $group->spawn(fn() => "ok");
    $group->spawn(fn() => throw new \RuntimeException("fail"));

    $group->seal();
    $group->awaitCompletion();

    // Без исключений — проверяем вручную
    $results = $group->getResults();
    $errors = $group->getErrors();

    echo "Успешных: " . count($results) . "\n"; // 1
    echo "Ошибок: " . count($errors) . "\n";    // 1
});

См. также