graceful_shutdown ​

(PHP 8.6+, True Async 1.0)

graceful_shutdown() — Avvia un arresto controllato dello scheduler. Tutte le coroutine ricevono una richiesta di annullamento.

Descrizione ​

graceful_shutdown(?Async\AsyncCancellation $cancellationError = null): void

Avvia la procedura di arresto controllato: tutte le coroutine attive vengono annullate e l'applicazione continua a funzionare fino al loro completamento naturale.

Parametri ​

cancellationError Un errore di annullamento opzionale da passare alle coroutine. Se non specificato, viene utilizzato un messaggio predefinito.

Valori di ritorno ​

Nessun valore di ritorno.

Esempi ​

Esempio #1 Gestione di un segnale di terminazione ​

<?php
use function Async\spawn;
use function Async\graceful_shutdown;
use Async\AsyncCancellation;

// Server che gestisce le richieste
spawn(function() {
    // Alla ricezione di un segnale — arresto controllato
    pcntl_signal(SIGTERM, function() {
        graceful_shutdown(new AsyncCancellation('Arresto del server'));
    });

    while (true) {
        // Elaborazione delle richieste...
    }
});
?>

Note ​

Nota: Le coroutine create dopo la chiamata a graceful_shutdown() verranno annullate immediatamente.

Nota: exit e die attivano automaticamente un arresto controllato.

Vedi anche ​

• Cancellazione — meccanismo di annullamento
• Scope — gestione del ciclo di vita