КомпонентиScope::cancel

Scope::cancel ​

(PHP 8.6+, True Async 1.0)

php
public function cancel(?AsyncCancellation $cancellationError = null): void

Скасовує всі корутини, що належать даній області видимості. Кожна активна корутина отримає AsyncCancellation. Якщо вказано $cancellationError, він буде використаний як причина скасування.

Параметри ​

cancellationError — користувацький виняток скасування. Якщо null, використовується стандартний AsyncCancellation.

Значення, що повертається ​

Значення не повертається.

Приклади ​

Приклад #1 Базове скасування ​

php
<?php

use Async\Scope;

$scope = new Scope();

$scope->spawn(function() {
    try {
        \Async\delay(60_000); // Long operation
    } catch (\Async\AsyncCancellation $e) {
        echo "Coroutine cancelled\n";
    }
});

// Cancel all coroutines
$scope->cancel();

Приклад #2 Скасування з користувацькою помилкою ​

php
<?php

use Async\Scope;
use Async\AsyncCancellation;

$scope = new Scope();

$scope->spawn(function() {
    try {
        \Async\delay(60_000);
    } catch (\Async\AsyncCancellation $e) {
        echo "Reason: " . $e->getMessage() . "\n";
    }
});

$error = new AsyncCancellation("Timeout exceeded");
$scope->cancel($error);

Дивіться також ​