PHP pcntl_signal 怎样临时替换信号处理器并恢复原设置

在 PHP CLI 守护脚本里，某个阶段可能需要暂时接管 SIGUSR1 或 SIGTERM。正确做法不是在结束时盲目写回 SIG_DFL，而是先用 pcntl_signal_get_handler() 保存当前处理器，再用 try...finally 把原值恢复。这样原来是自定义 callable、忽略信号还是默认处理，退出临界区后都不会被悄悄改掉。

官方地址：https://www.php.net/manual/en/function.pcntl-signal.php

一、先把旧处理器当成状态保存

这个问题最容易错在“旧处理器”并不一定是函数名。PHP 手册定义的返回值可能是 callable，也可能是表示默认处理和忽略处理的整数常量。因此保存变量时不要假设它一定能直接调用，只要原样交给后面的 pcntl_signal() 即可。

二、用 try...finally 包住临时接管区

我在需要临时屏蔽一类业务动作的 CLI 任务里，会把保存、替换和恢复放在同一个小函数中。临时回调只记录收到的信号，不把子进程管理、信号屏蔽等其他职责混进来；真正的工作可以替换为清理、刷新或重载配置。

关键点是 $previous 不要被重新包装成一个新闭包，也不要在 finally 中无条件写 SIG_DFL。前者会丢失原 callable 的身份，后者会把“原本忽略信号”的进程改成默认行为。

三、恢复动作和信号分发是两件事

安装处理器不等于当前代码一定会立即执行回调。启用 pcntl_async_signals(true) 可以使用异步分发；如果选择手动方式，则要在合适的位置调用 pcntl_signal_dispatch()。无论采用哪种分发策略，旧处理器的保存与恢复仍是同一套逻辑，不能因为回调尚未触发就省略。

还要确认运行环境是 CLI，并检查 function_exists('pcntl_signal_get_handler')。这个读取函数从 PHP 7.1.0 才加入；较老版本没有可靠的通用方式查询任意信号的当前 callable，最好由更高层代码明确交接处理器，而不是猜测恢复值。

常见问题

pcntl_signal 会把旧处理器压入栈里吗？

不会。它会替换指定信号的当前处理器，所以需要临时接管时必须自行保存旧值。

为什么不能直接恢复 SIG_DFL？

因为旧状态可能是自定义 callable 或 SIG_IGN。直接写回默认值会改变调用方原有的进程语义。

finally 能保证信号一定被恢复吗？

它能覆盖正常返回和 PHP 异常路径，但无法替代操作系统层面的强制终止；SIGKILL 等不可捕获场景不属于这段代码的恢复边界。