乐趣区

关于php:PHP-实现平滑关闭重启

写过 CLI 常驻过程的老司机必定遇到过这么一个问题:在须要更新程序的时候,我要怎样才能平安敞开老过程?你可能会想到 NGINXphp-fpm 之类的平滑重启是给过程发送 USR2 信号,而后它就会将以后申请解决完再退出。

但过程是怎么接管信号、解决信号,预计就不是很多人能说分明了。

原理

要实现平滑敞开 / 重启不难,这里先解说两个知识点:

阻塞信号

当咱们的程序正在解决一个工作的时候,你必定不心愿它中途被终止,比如说你在执行一个数据库事务,必定不心愿事务还没被提交过程就被终止了。

<?php
echo "开始执行事务" . PHP_EOL;

// 模仿一些耗时的操作
$finish_time = time() + 5;
while (time() < $finish_time) {
}

echo "事务执行结束" . PHP_EOL;

下面这段代码,如果你在第二个 echo 之前用 kill 命令去杀死这个过程,那么第二个 echo 就不会被执行了。那能不能做到在事务过程中临时先疏忽 kill 信号呢?

能。咱们能够应用 pcntl_sigprocmask() 来阻塞信号,让事务实现之后再响应 kill 信号。

<?php

// 阻塞信号
$sig_set = array(SIGINT, SIGTERM); // 要阻塞的信号汇合
pcntl_sigprocmask(SIG_BLOCK, $sig_set); // SIG_BLOCK: 把信号退出到以后阻塞信号中

echo date("[Y-m-d H:i:s]") . "开始执行事务" . PHP_EOL;

$finish_time = time() + 5;
while (time() < $finish_time) {
}

echo date("[Y-m-d H:i:s]") . "事务执行结束" . PHP_EOL;

pcntl_sigprocmask(SIG_UNBLOCK, $sig_set); // SIG_UNBLOCK: 从以后阻塞信号中移出信号 

同样的,在第二个 echo 之前按下 Ctrl + C 或者用 kill 命令去杀这个过程,你会发现第二个 echo 失常执行了,并且两条输入的工夫距离是 5 秒。

咱们的常驻过程通常是在一个 while(true) 循环中去执行反复的工作,如果这么写的话:

<?php

while (true) {pcntl_sigprocmask(SIG_BLOCK, $sig_set);

    // ...

    pcntl_sigprocmask(SIG_UNBLOCK, $sig_set);
}

咱们是能够保障一个事务不会被打断,然而咱们的程序还不晓得是不是曾经接管到信号了,并且把阻塞信号移除之后过程立即就退出了,没方法去做一些收尾工作(比方敞开文件)。

解决信号

为了解决下面提到的问题,咱们须要在信号产生的时候去做收尾工作,而后再退出过程。

pcntl 扩大提供了一些信号相干的函数,咱们能够应用 pcntl_signal()pcntl_signal_dispatch() 来注册信号处理器和散发信号。

<?php

$sig_handler = function ($signo) {echo "收到信号 {$signo}" . PHP_EOL;
};
pcntl_signal(SIGINT, $sig_handler); // 给 SIGINT 信号注册一个处理器

// 模仿耗时操作
echo "开始执行事务" . PHP_EOL;
$finish_time = time() + 5;
while(true) {if (time() > $finish_time) {
        echo "事务执行结束" . PHP_EOL;
        break;
    }
}

pcntl_signal_dispatch(); // 散发信号 

执行下面这段代码并在 5 秒内按下 Ctrl + C,你会看到 sig_handler 被执行了;而如果不按下 Ctrl + C,那么 sig_handler 就不会被执行。

到这里你应该曾经了解了 pcntl_signal()pcntl_signal_dispatch() 的用法了,把它放到到刚刚的代码试试

<?php

$sig_handler = function ($signo) {echo "收到信号 {$signo}" . PHP_EOL;
};
$sig_set = array(SIGINT, SIGTERM);
foreach ($sig_set as $sig) {pcntl_signal($sig, $sig_handler); // 注册多个信号
}

// [1]

while (true) {// [2-1]
    pcntl_sigprocmask(SIG_BLOCK, $sig_set);
    // [2-2]

    // ...

    // [2-3]
    pcntl_sigprocmask(SIG_UNBLOCK, $sig_set);
    // [2-4]
}

// [3]

pcntl_signal_dispatch() 该放哪里呢?是 [1] [2] 还是 [3]?先入手试一下

而后你会发现,只有放在 [2] 能力让信号处理器执行。同时这个试验也通知咱们 pcntl_signal_dispatch() 要在信号产生后才会使处理器执行:放在 [1] 时,除非你手速足够快,不然在你按下 Ctrl + C 或者是 kill 之前就曾经执行过了;而放在 [3] 它就永远没机会执行。

至于放在 [2] 的哪个地位,我倡议是放在 [2-4],因为这个时候曾经解决完工作了。

拼起来

到这里你曾经理解平滑敞开 / 重启的原理了,咱们把下面的半成品代码(因为在收到信号后可能还会进入下一层循环)整顿一下:

<?php

$running = true;

$sig_handler = function ($signo) use (&$running) {echo "收到信号 {$signo}" . PHP_EOL;
    // 做收尾工作
    $running = false;
};
$sig_set = array(SIGINT, SIGTERM, SIGUSR2 /* 相熟的 USR2 信号不能漏 */);
foreach ($sig_set as $sig) {pcntl_signal($sig, $sig_handler); // 注册多个信号
}


while ($running) {pcntl_sigprocmask(SIG_BLOCK, $sig_set);

    // ... 业务逻辑

    pcntl_sigprocmask(SIG_UNBLOCK, $sig_set);
    pcntl_signal_dispatch();}

咱们就失去了一个能够平滑程序的常驻过程框架,你也能够把它封装成一个类。

思考

仔细的你可能会发现,下面这段代码如果业务逻辑呈现了死循环,还是没方法退出,那么咱们能不能设置个超时强制开始解决收尾工作而后退出过程呢?

先思考一下,当前我再写一篇文章阐明 :-)


本文首发于自己博客:https://yian.me/blog/what-is/php-graceful-shutdown.html

退出移动版