看看 PHP 高性能框架 Workerman 源码中信号的使用姿势

<?php

// 定义信号处理函数
function signalHandler($signal)
{
    switch ($signal) {
        case SIGINT:
            // 比如公司广播响起了吃 下午茶 的音乐
            echo "捕获到 SIGINT 信号... " . PHP_EOL;
            // 接下来可以自行实现相应的逻辑
            exit;
        case SIGTERM:
            // 比如公司广播又响起了线上 Bug 的告警声
            echo "捕获到 SIGTER 信号... " . PHP_EOL;
            // 接下来可以自行实现相应的逻辑
            exit;
        case SIGALRM:
            // 比如公司广播又通知你参加某某答辩会
            echo "捕获到 SIGALRM 信号... " . PHP_EOL;
            // 接下来可以自行实现相应的逻辑
            // 当然你也可以不处理，任由它去
            exit;
        default:
            echo "捕获到未知信号: $signal " . PHP_EOL;
            exit;
    }
}

// 注册信号回调函数
// 就好比接受到不同的通知，就应该要做对应的事情
// 这里统一回调 signalHandler 这个函数，你也可以定义不同的函数
pcntl_signal(SIGINT, 'signalHandler');
pcntl_signal(SIGTERM, 'signalHandler');

// 输出一下当前的进程号，方便测试
echo "当前进程 PID: " . getmypid() . PHP_EOL;

// 不断监听信号，接收到信号后调用相应的信号回调函数
// 这里就像你自己的耳朵一直在等待接收通知
while (true) {
    pcntl_signal_dispatch();
}

[manongsen@root php_signal]$ php index.php 
当前进程 PID: 43195

[manongsen@root php_signal]$ kill -SIGTERM 43195

[manongsen@root php_signal]$ php index.php 
当前进程 PID: 43195
捕获到 SIGTERM 信号...

<?php

// 定义信号处理函数
function signalHandler($signal)
{
    $pid = getmypid();
    // 回收子进程资源
    // 你接收到了他跑路的信号，开始回收他的代码权限、账号等资源
    $status = 0;
    $cid = pcntl_wait($status, \WUNTRACED);
    echo "父进程: {$pid}, 收到子进程: {$cid}, 退出信号: {$signal}" . PHP_EOL;
    
    // 最后你抵不住也跑路了
    echo "父进程: {$pid}, 最后也退出了" . PHP_EOL;
    exit;
}

// 在当前进程 Fork 一个子进程
// 比如终于招聘了一个替补你的人
$pid = pcntl_fork();
if ( $pid < 0 ) {
 // 这里被你放鸽子了
 // 你也摆烂直接跑路算了
    exit('fork error');
} else if( $pid > 0 ) {
   // 父进程执行空间 ...
   echo "父进程: " . getmypid() . PHP_EOL;

   // 注册信号回调函数
   // SIGCHLD 表示一个子进程已经终止或停止
   // 你相当于给他触发跑路的信号，准备了一个处理方案
   pcntl_signal(SIGCHLD, "signalHandler");

   // 监听信号
   // 你相当于一直监听他的动向
   while(true){
      pcntl_signal_dispatch();
   }
} 

// 子进程执行空间 ...
$cid = getmypid();
echo "子进程: {$cid}" . PHP_EOL;

// 休眠 5 秒钟
sleep(5);

// 退出
// 假设他干了5秒钟就跑路了
exit;

[manongsen@root php_signal]$ php index.php 
父进程: 47008
子进程: 47009
子进程: 47009 退出了
父进程: 47008, 收到子进程: 47009, 退出信号: 20
父进程: 47008, 最后也退出了

<?php

// workerman/Worker.php:548
public static function runAll()
{
    // ...

    // 注册信号回调函数
    static::installSignal();
    
    // ...
    
    // 监听 Worker 子进程信号
    static::monitorWorkers();
}

<?php

// workerman/Worker.php:1140
protected static function installSignal()
{
    // ...
    // 信号回调函数
    $signalHandler = '\Workerman\Worker::signalHandler';
    // 退出信号
    \pcntl_signal(\SIGINT, $signalHandler, false);
    \pcntl_signal(\SIGTERM, $signalHandler, false);
    \pcntl_signal(\SIGHUP, $signalHandler, false);
    \pcntl_signal(\SIGTSTP, $signalHandler, false);
    // 优雅退出信号
    \pcntl_signal(\SIGQUIT, $signalHandler, false);
    // 重载信号
    \pcntl_signal(\SIGUSR1, $signalHandler, false);
    // 优雅重载信号
    \pcntl_signal(\SIGUSR2, $signalHandler, false);
    // 状态信号
    \pcntl_signal(\SIGIOT, $signalHandler, false);
    // 连接状态信号
    \pcntl_signal(\SIGIO, $signalHandler, false);
    // SIGPIPE 管道信号，忽略该信号
    \pcntl_signal(\SIGPIPE, \SIG_IGN, false);
}

<?php

// workerman/Worker.php:1220
public static function signalHandler($signal)
{
    switch ($signal) {
        // 退出
        case \SIGINT:
        case \SIGTERM:
        case \SIGHUP:
        case \SIGTSTP:
            static::$_gracefulStop = false;
            // 这里会把所有的 Woker 子进程 Kill 掉，并且销毁相应子进程的 Event-Loop 事件循环
            static::stopAll();
            break;
        // 优雅的退出
        case \SIGQUIT:
            // 优雅退出在调用 posix_kill 函数时传递的是 SIGTERM 信号
            static::$_gracefulStop = true;
            static::stopAll();
            break;
        // 重载
        case \SIGUSR2:
        case \SIGUSR1:
            if (static::$_status === static::STATUS_SHUTDOWN || static::$_status === static::STATUS_RELOADING) {
                return;
            }
            static::$_gracefulStop = $signal === \SIGUSR2;
            static::$_pidsToRestart = static::getAllWorkerPids();
            // 对 Worker 进程实现重载
            static::reload();
            break;
        // 展现状态
        case \SIGIOT:
            // 这里会输出一些 全局状态信息、进程状态信息
            // 比如 load-average、event-loop、workers-count 等
            static::writeStatisticsToStatusFile();
            break;
        // 展现连接状态
        case \SIGIO:
            // 这里会输出一些进程连接相关的统计信息
            // 比如 Recv-Q、Send-Q、Bytes-R、Bytes-W、Status 等
            static::writeConnectionsStatisticsToStatusFile();
            break;
    }
}

<?php

// workerman/Worker.php:1735
protected static function monitorWorkersForLinux()
{
    // 默认运行状态
    static::$_status = static::STATUS_RUNNING;
    // 一直监听直到所有的进程退出
    while (1) {
        \pcntl_signal_dispatch();
        $status = 0;
        // 这些做一些子进程资源的回收工作
        $pid    = \pcntl_wait($status, \WUNTRACED);
        \pcntl_signal_dispatch();

        // ...

        // 做一些清理工作
        if (static::$_status === static::STATUS_SHUTDOWN && !static::getAllWorkerPids()) {
            // 这里还会回调用户设定的 Stop 回调函数，便于做一些业务上的处理
            // 然后直接 exit 当前进程
            static::exitAndClearAll();
        }
    }
}