ComposantsScope::dispose

Scope::dispose ​

(PHP 8.6+, True Async 1.0)

php
public function dispose(): void

Ferme le scope et annule toutes les coroutines qu'il contient. Après l'appel à dispose(), le scope est marqué comme fermé et annulé. De nouvelles coroutines ne peuvent pas être ajoutées à un scope fermé.

Pour un scope sans le drapeau dispose-safely (new Scope() par défaut), cela équivaut à appeler cancel() suivi de la fermeture du scope. Un scope qui a le drapeau, activé par allowZombies() ou hérité d'un parent qui l'a, comme le scope principal, laisse ses coroutines continuer à s'exécuter comme zombies à la place, exactement comme disposeSafely().

Valeur de retour ​

Aucune valeur n'est retournée.

Exemples ​

Exemple #1 Fermeture forcée d'un scope ​

php
<?php

use Async\Scope;

$scope = new Scope();

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

// Toutes les coroutines seront annulées, le scope fermé
$scope->dispose();

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

Exemple #2 Nettoyage dans un bloc try/finally ​

php
<?php

use Async\Scope;

$scope = new Scope();

try {
    $scope->spawn(function() {
        // Logique métier
        \Async\delay(5000);
    });

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

Voir aussi ​