Documentación

Aprenda a usar TrueAsync para crear aplicaciones PHP concurrentes.

Scope::dispose

(PHP 8.6+, True Async 1.0)

public function dispose(): void

Cancela de forma forzada todas las corrutinas del ámbito y lo cierra. Después de llamar a dispose(), el ámbito se marca como cerrado y cancelado. No se pueden agregar nuevas corrutinas a un ámbito cerrado.

Esto es equivalente a llamar a cancel() seguido del cierre del ámbito.

Valor de retorno

No se devuelve ningún valor.

Ejemplos

Ejemplo #1 Cierre forzado de un ámbito

<?php

use Async\Scope;

$scope = new Scope();

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

// All coroutines will be cancelled, scope closed
$scope->dispose();

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

Ejemplo #2 Limpieza en un bloque try/finally

<?php

use Async\Scope;

$scope = new Scope();

try {
    $scope->spawn(function() {
        // Business logic
        \Async\delay(5000);
    });

    $scope->awaitCompletion();
} finally {
    $scope->dispose();
}

Ver también