Что такое pcntl_signal_dispatch

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

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

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

> Важно: Для использования функций pcntl необходимо, чтобы PHP был собран с поддержкой PCNTL (Process Control).

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

<?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 вызывается в процессе выполнения программы для обработки всех зарегистрированных сигналов.

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

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

SIGTERM (15) - сигнал корректного завершения процесса

SIGINT (2) - сигнал прерывания (обычно Ctrl+C)

SIGHUP (1) - сигнал "висящего" терминала

SIGUSR1 (10) - пользовательский сигнал 1

SIGUSR2 (12) - пользовательский сигнал 2

SIGCHLD (17) - сигнал завершения дочернего процесса

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

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

<?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();
?>