php 8.6的常驻cli任务可以用pcntl接收sigterm,在停止领取新工作后完成当前任务再退出。信号处理函数只应设置停止标志,真正的资源清理放在主循环中。这要求unix类平台的cli及pcntl扩展,不适用于把进程控制代码直接放进fpm请求。

PHP官方文档中的PCNTL信号相关说明。 图源:PHP Documentation Group(CC BY3.0)。
让处理函数只记录意图
<?php
if (PHP_SAPI !== 'cli' || !extension_loaded('pcntl')) {
throw new RuntimeException('需要Unix CLI及pcntl扩展');
}
$stop = false;
pcntl_async_signals(true);
$onStop = static function (int $signal) use (&$stop): void {
$stop = true;
};
if (!pcntl_signal(SIGTERM, $onStop) || !pcntl_signal(SIGINT, $onStop)) {
throw new RuntimeException('信号处理器注册失败');
}
try {
for ($job = 1; $job <= 100 && !$stop; $job++) {
// 用受控短任务模拟领取和处理;实际领取操作也应有超时。
printf("job=%d start\n", $job);
$deadline = hrtime(true) + 1000000000;
while (hrtime(true) < $deadline) { usleep(10000); }
printf("job=%d done\n", $job);
}
} finally {
fwrite(STDERR, "worker stopping\n");
}
exit(0);从另一个终端发送一次停止信号
运行脚本后记录其实际pid,再用kill -TERM 该pid。预期当前job能够到达done,随后不再开始下一项;正常结束应返回0。示例只是有限循环,替换为队列时需在每次领取前检查标志,并安排任务确认或失败回收。
阻塞调用仍要设置自己的超时
异步信号处理并不意味着回调会立即打断任意内部函数。数据库查询或curl_exec长时间阻塞时,PHP层处理函数可能要等调用返回才执行。服务管理器的停止等待时间应覆盖合理的任务收尾窗口,但SIGKILL、进程崩溃和机器断电无法依靠finally保证清理。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

PHP官方文档中的PCNTL信号相关说明。 图源:PHP Documentation Group(CC BY3.0)。
不要在信号处理器中进行复杂数据库写入或退出整个程序。业务任务应有可重入和幂等设计,避免停止后重新领取导致重复副作用。信号只负责通知退出意图,不是分布式任务完成凭证。


















