(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
pcntl_signal — Установка обработчика сигнала
Функция pcntl_signal() устанавливает новый
обработчик сигнала или заменяет текущий обработчик сигнала,
указанный в аргументе signal.
signalНомер сигнала.
handler
Обработчик сигнала. Это может быть или callable,
указатель на функцию, которая будет запущена для обработки сигнала,
или значение одной из глобальных констант:
SIG_IGN или SIG_DFL,
которые, соответственно, либо приведут к игнорированию сигнала,
либо восстановлению обработчика по умолчанию.
Если передан тип callable, он должен иметь следующую сигнатуру:
signalsiginfoЗамечание:
Обратите внимание, что когда вы задаёте в качестве обработчика метод объекта, счётчик ссылок на данный объект будет увеличен на единицу, что сохранит его в памяти до тех пор, пока вы либо не смените обработчик на что-то другое, либо до тех пор пока скрипт полностью не завершит свою работу.
restart_syscallsОпределяет, должен ли использоваться перезапуск системного вызова при поступлении сигнала.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
| Версия | Описание |
|---|---|
| 7.1.0 | Начиная с PHP 7.1.0 обработчику callback-функции передаётся второй аргумент, содержащий структуру siginfo определённого сигнала. Эти данные будут переданы только в том случае, если операционная система поддерживает структуры siginfo_t. Если в операционной системе не реализована поддержка структуры siginfo_t, то в качестве второго аргумента будет передан NULL. |
Пример #1 Пример использования pcntl_signal()
<?php
// Обязательно
declare(ticks = 1);
// функция обработки сигнала
function sig_handler($signo)
{
switch ($signo) {
case SIGTERM:
// Обработка задач остановки
exit;
break;
case SIGHUP:
// обработка задач перезапуска
break;
case SIGUSR1:
echo "Получен сигнал SIGUSR1...\n";
break;
default:
// Обработка других сигналов
}
}
echo "Установка обработчиков сигналов...\n";
// Установка обработчиков сигналов
pcntl_signal(SIGTERM, "sig_handler");
pcntl_signal(SIGHUP, "sig_handler");
pcntl_signal(SIGUSR1, "sig_handler");
// или можете использовать объект
// pcntl_signal(SIGUSR1, array($obj, "do_something"));
echo "Отправка сигнала SIGUSR1 себе...\n";
// Отправка SIGUSR1 процессу с текущим id (т.е. себе)
// для использования функций posix_* требуется модуль posix
posix_kill(posix_getpid(), SIGUSR1);
echo "Завершено\n";
?>pcntl_signal() не собирает обработчики сигналов в стек, а заменяет их.