Scope::dispose
(PHP 8.6+, True Async 1.0)
public function dispose(): void
Annule de manière forcée toutes les coroutines du scope et le ferme. 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é.
Cela équivaut à appeler cancel() suivi de la fermeture du scope.
Valeur de retour
Aucune valeur n’est retournée.
Exemples
Exemple #1 Fermeture forcée d’un scope
<?php
use Async\Scope;
$scope = new Scope();
$scope->spawn(function() {
try {
\Async\delay(60_000);
} catch (\Async\CancelledException) {
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
use Async\Scope;
$scope = new Scope();
try {
$scope->spawn(function() {
// Logique métier
\Async\delay(5000);
});
$scope->awaitCompletion();
} finally {
$scope->dispose();
}
Voir aussi
- Scope::disposeSafely — Fermeture sécurisée (avec zombies)
- Scope::disposeAfterTimeout — Fermeture après un délai
- Scope::cancel — Annuler sans fermer le scope