КомпонентыScope::dispose

Scope::dispose ​

(PHP 8.6+, True Async 1.0)

php
public function dispose(): void

Закрывает scope и отменяет все его корутины. После вызова dispose() scope помечается как закрытый и отменённый. Новые корутины не могут быть добавлены в закрытый scope.

Для scope без флага dispose-safely (new Scope() по умолчанию) это эквивалент вызова cancel() с последующим закрытием scope. Scope с флагом, включённым через allowZombies() или унаследованным от родителя с флагом, например от main scope, вместо отмены оставляет корутины работать как zombie, так же как disposeSafely().

Возвращаемое значение ​

Функция не возвращает значения.

Примеры ​

Пример #1 Принудительное закрытие scope ​

php
<?php

use Async\Scope;

$scope = new Scope();

$scope->spawn(function() {
    try {
        \Async\delay(60_000);
    } catch (\Async\AsyncCancellation) {
        echo "Корутина отменена при dispose\n";
    }
});

// Все корутины будут отменены, scope закрыт
$scope->dispose();

var_dump($scope->isClosed());    // bool(true)
var_dump($scope->isCancelled()); // bool(true)

Пример #2 Очистка в блоке try/finally ​

php
<?php

use Async\Scope;

$scope = new Scope();

try {
    $scope->spawn(function() {
        // Рабочая логика
        \Async\delay(5000);
    });

    $scope->awaitCompletion(Async\timeout(5000));
} finally {
    $scope->dispose();
}

См. также ​