graceful_shutdown

(PHP 8.6+, True Async 1.0)

graceful_shutdown() — Ініціює плавне завершення роботи планувальника. Усі корутини отримують запит на скасування.

Опис

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

Запускає процедуру плавного завершення: усі активні корутини скасовуються, а застосунок продовжує працювати, поки вони не завершаться природним шляхом.

Параметри

cancellationError Необов’язкова помилка скасування, що передається корутинам. Якщо не вказано, використовується повідомлення за замовчуванням.

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

Не повертає значення.

Приклади

Приклад #1 Обробка сигналу завершення

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

// Сервер, що обробляє запити
spawn(function() {
    // При отриманні сигналу — плавно завершити роботу
    pcntl_signal(SIGTERM, function() {
        graceful_shutdown(new AsyncCancellation('Server shutdown'));
    });

    while (true) {
        // Обробка запитів...
    }
});
?>

Примітки

Примітка: Корутини, створені після виклику graceful_shutdown(), будуть негайно скасовані.

Примітка: exit та die автоматично запускають плавне завершення.

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

• Cancellation — механізм скасування
• Scope — управління життєвим циклом