(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
pcntl_signal — Instala un gestor de señales
pcntl_signal() instala un nuevo gestor
de señales o reemplaza el gestor de señales actual
para la señal indicada por el parámetro
signal
.
signal
El número de la señal.
handler
El gestor de señales. Puede ser un callable,
que será llamado para gestionar la señal, o bien una de las dos
constantes globales SIG_IGN
o SIG_DFL
,
que, respectivamente, ignorarán la señal o restaurarán el gestor
de señales por defecto.
Si se proporciona un callable, debe implementar la siguiente firma:
signal
siginfo
Nota:
Téngase en cuenta que cuando se configura el gestor con un método de objeto, el contador de referencia del objeto se incrementa, lo que lo hace persistente hasta que se cambie el gestor de señales por otro, o hasta que el script termine.
restart_syscalls
El parámetro opcional restart_syscalls
especifica si la llamada al sistema de reinicio (restarting) debe ser utilizada
cuando llega esta señal.
Versión | Descripción |
---|---|
7.1.0 | A partir de PHP 7.1.0 el gestor de la función de retrollamada tiene un segundo argumento que contiene el siginfo de esa señal específica. Estos datos solo se proporcionan si el sistema operativo tiene la estructura siginfo_t. Si el sistema operativo no implementa siginfo_t, se proporciona NULL. |
Ejemplo #1 Ejemplo con pcntl_signal()
<?php
pcntl_async_signals(true);
// gestor de señales del sistema
function sig_handler($signo)
{
switch ($signo) {
case SIGTERM:
// gestión de la extinción
exit;
break;
case SIGHUP:
// gestión del reinicio
break;
case SIGUSR1:
echo "Recibida la señal SIGUSR1...\n";
break;
default:
// gestión de otras señales
}
}
echo "Instalación del gestor de señales...\n";
// Instalación de los gestores de señales
pcntl_signal(SIGTERM, "sig_handler");
pcntl_signal(SIGHUP, "sig_handler");
pcntl_signal(SIGUSR1, "sig_handler");
// o bien utilice un objeto
// pcntl_signal(SIGUSR1, array($obj, "hacer_algo"));
echo"Generación de una señal SIGUSR1 a mí mismo...\n";
// envío de SIGUSR1 al identificador de proceso actual
// las funciones posix_* requieren la extensión posix
posix_kill(posix_getpid(), SIGUSR1);
echo "Hecho\n";
?>
La función pcntl_signal() no apila los gestores de señales, sino que los reemplaza.
Existen varios métodos para dispatchar los gestores de señales:
Cuando las señales son dispatchadas de manera asíncrona o utilizando una ejecución basada en ticks, las funciones bloqueantes como sleep() pueden ser interrumpidas.