PHP信号处理器内禁止IO操作是因操作系统对异步信号上下文的硬性约束：信号处理函数运行在不可预测栈帧中，执行fopen、write等IO调用易引发死锁、堆不一致、重入崩溃等问题；安全做法仅限设标志、写管道或用signalfd移交主循环处理。
PHP 信号处理器内禁止执行 IO 操作，不是 PHP 自己定的“规矩”，而是操作系统（Linux/Unix）对信号处理上下文的硬性约束——信号是异步中断，处理函数运行在不可预测的栈帧和调度时机中，任何可能阻塞、重入或触发内存分配的系统调用都极大概率导致进程挂死、死锁或未定义行为。
为什么不能在信号处理器里做 IO？
根本原因在于：信号处理函数运行时，进程可能正处在任意系统调用中途（比如刚进入 write() 却还没返回），此时若信号 handler 再调用 fopen()、file_put_contents()、echo（终端输出本质是 write）、甚至 error_log()（默认写文件），就可能：
- 触发 libc 的内部锁（如 stdio 缓冲区锁），与被中断的主线程形成死锁；
- 调用 malloc/free 导致堆状态不一致（信号 handler 是异步进入的，malloc 不是异步信号安全函数）；
- 引发重入问题：比如主线程正在执行 mysql_query()，信号 handler 又调用 mysqli_connect()，底层驱动无法保证线程/信号安全；
- PHP 的 Zend VM 此时可能处于非可重入状态（如 GC 正在标记对象、符号表正在修改），IO 操作可能间接触发 GC 或扩展回调，直接崩溃。
哪些操作明确不安全？
以下全部属于 异步信号不安全（async-signal-unsafe） 函数，在 pcntl_signal 回调中必须避免：
- 所有文件 IO：fopen、file_get_contents、file_put_contents、echo、print、var_dump；
- 内存管理：malloc、free、emalloc（PHP 内部）、new（会触发 emalloc）；
- 网络 IO：curl_exec、stream_socket_client、socket_write；
- 日志类：error_log（默认 file 模式）、syslog（部分实现不安全）；
- 扩展调用：绝大多数 PHP 扩展函数（包括 PDO、Redis、MongoDB 等）均未声明为 async-signal-safe。
安全且实用的替代方案
核心思路只有一条：信号 handler 只做最轻量的事——设标志、写管道、发通知，把实际工作交给主事件循环或独立线程去完成。
立即学习“PHP免费学习笔记（深入）”；
- 使用 signalfd（Linux 特有） + event loop：用 pcntl_sigprocmask 屏蔽信号，再通过 signalfd（需自行封装或借助 ext-event）将信号转为文件描述符事件，由主循环统一处理。这样信号逻辑就退化为普通 I/O 事件，完全规避 handler 上下文限制。
- 自建信号管道（pipe）：父进程创建一对非阻塞 pipe，在 signal handler 中仅用 write()（POSIX 保证 write 整数 fd 是 async-signal-safe）向管道写一个字节；主循环用 stream_select 或 pcntl_async_signals(false) + 轮询管道读端，一旦可读就执行真正的清理/日志/退出逻辑。
- 设置 volatile 标志 + 主循环轮询：定义全局 static $shutdown_requested = false;，handler 中只做 $shutdown_requested = true;（注意：PHP 7.4+ 的静态变量赋值是原子且安全的）；主循环每轮检查该标志，再执行 fclose、数据库 close、日志 flush 等完整流程。
- 用 pcntl_signal_dispatch() 配合异步关闭：禁用异步信号（pcntl_async_signals(false)），改为主循环定期调用 pcntl_signal_dispatch()，此时信号回调运行在主栈上，不再是中断上下文，IO 安全性大幅提升（但仍建议避免复杂操作，优先走管道或标志）。
一个最小可行示例（管道法）
在 worker 启动时：
// 创建非阻塞管道$sigPipe = stream_socket_pair(AF_UNIX, SOCK_STREAM, 0);
stream_set_blocking($sigPipe[0], false);
stream_set_blocking($sigPipe[1], false);
// 屏蔽 SIGTERM，改由管道接收
pcntl_sigprocmask(SIG_BLOCK, [SIGTERM]);
// 注册 handler：只写管道
pcntl_signal(SIGTERM, function() use ($sigPipe) {
@fwrite($sigPipe[1], "T"); // 异步信号安全
});
// 主循环监听管道
while (true) {
$read = [$sigPipe[0]];
if (stream_select($read, $w = null, $e = null, 0, 100000) > 0) {
@fread($sigPipe[0], 1);
echo "收到终止请求，开始优雅退出...\n";
// 此处可安全执行 fclose、PDO->close、日志 flush 等
break;
}
sleep(1); // 实际工作
}
