pcntl_signal_dispatch: Обработка сигналов в PHP

Что такое pcntl_signal_dispatch

pcntl_signal_dispatch — это функция в PHP, которая используется для ручной обработки всех отправленных процессу сигналов. Сигналы — это уведомления, отправляемые процессам операционной системы для оповещения их об определенных событиях.

Назначение функции

Функция pcntl_signal_dispatch выполняет все зарегистрированные обработчики сигналов, которые были установлены с помощью функции pcntl_signal.

Пример использования

<?php
// Регистрируем обработчик сигнала
pcntl_signal(SIGTERM, "handle_signal");

// Ваш код
echo "Выполняется основная программа...\n";

// Вызываем pcntl_signal_dispatch, чтобы обработать все зарегистрированные сигналы
pcntl_signal_dispatch();

// Ваш код
echo "Продолжение выполнения программы...\n";

// Обработчик сигнала
function handle_signal($signal) {
    echo "Received signal: $signal\n";
    // Выполняем необходимые действия при получении сигнала
    if ($signal == SIGTERM) {
        echo "Завершаем работу...\n";
        exit(0);
    }
}

// Ваш код
?>

В этом примере pcntl_signal(SIGTERM, "handle_signal") устанавливает обработчик сигнала SIGTERM для вызова функции handle_signal, когда процесс получает сигнал завершения. Функция pcntl_signal_dispatch вызывается в процессе выполнения программы для обработки всех зарегистрированных сигналов.

Основные сигналы

Linux Хостинг

Надежный и быстрый веб-хостинг!

• Бесплатный домен
• Современные сервера
• NVMe диски
• 7 дней теста бесплатно

Просмотреть тарифы

Распространенные сигналы в POSIX-системах:

Практическое применение

Демон-процесс с обработкой сигналов

<?php
// Демон для обработки очереди задач
class WorkerDaemon {
    private $running = true;

public function __construct() {
        // Регистрируем обработчики сигналов
        pcntl_signal(SIGTERM, [$this, 'handleSignal']);
        pcntl_signal(SIGINT, [$this, 'handleSignal']);
        pcntl_signal(SIGHUP, [$this, 'handleSignal']);
    }

public function run() {
        echo "Демон запущен. PID: " . getmypid() . "\n";

while ($this->running) {
            // Обрабатываем сигналы
            pcntl_signal_dispatch();

// Выполняем работу
            $this->processQueue();

// Небольшая пауза
            usleep(100000); // 100ms
        }

echo "Демон завершает работу...\n";
    }

private function processQueue() {
        // Обработка задач из очереди
        echo "Обрабатываю задачи...\n";
    }

public function handleSignal($signal) {
        echo "Получен сигнал: $signal\n";

switch ($signal) {
            case SIGTERM:
            case SIGINT:
                echo "Завершаем работу...\n";
                $this->running = false;
                break;
            case SIGHUP:
                echo "Перезагрузка конфигурации...\n";
                $this->reloadConfig();
                break;
        }
    }

private function reloadConfig() {
        // Перезагрузка конфигурации
        echo "Конфигурация перезагружена\n";
    }
}

// Запуск демона
$daemon = new WorkerDaemon();
$daemon->run();
?>

Рекомендации по использованию

Дополнительно может быть полезна смежная статья: pcntl_signal_dispatch.

• Регулярно вызывайте pcntl_signal_dispatch в длительных циклах
• Используйте обработчики сигналов для корректного завершения процессов
• Избегайте сложной логики в обработчиках сигналов
• Проверяйте доступность PCNTL перед использованием функций
• Используйте пользовательские сигналы для кастомной логики приложения