PHP文生图生成中断？进程守护法-php教程-PHP中文网

php文生图脚本在cli下易因sighup等信号中断，根本原因是linux进程会话管理机制；nohup+&可快速规避终端退出问题，但需注意路径、日志、内存控制；supervisor才是生产环境实用守护方案。

php文生图生成中断？进程守护法

PHP 文生图任务（比如调用 Stable Diffusion API、调用本地 Python subprocess 生成图像、或使用 GD/Imagick 处理大量图片）一旦在 CLI 下直接运行，很容易因 SSH 断开、超时、信号中断或未捕获异常而中途退出——这不是“生成中断”，而是进程被杀掉了。守护化不是万能解药，但能解决“非代码逻辑失败”导致的意外退出。

为什么 PHP 文生图脚本一断网就停？

根本原因不是 PHP 或图像库的问题，而是 Linux 进程生命周期管理机制在起作用：

直接执行 php generate.php：进程挂在当前终端 session 下，SSH 断开 → 触发 SIGHUP → 默认终止进程
用 php generate.php &：只是转入后台 job，仍属当前 session，终端退出照样收 SIGHUP
即使加了 ignore_user_abort(true) 或 set_time_limit(0)：这些只对 Web SAPI 有效，CLI 模式下完全不生效

文生图常需几秒到几分钟，中间任何一次终端挂起、网络抖动、用户误关窗口，都会让整个生成链路断掉——你看到的“中断”，其实是进程消失了。

nohup + & 是最快上线方案，但有硬伤

适合临时调试、单次批量任务，命令形如：

nohup php /path/to/generate.php > /var/log/imggen.log 2>&1 & echo $! > /var/run/imggen.pid

关键点：

nohup 拦截 SIGHUP，避免终端退出杀进程
> ... 2>&1 把 stdout/stderr 合并重定向，否则日志会丢
echo $! > ... 保存 PID，方便后续 kill $(cat /var/run/imggen.pid)
不要漏掉最后的 &，否则 nohup 仍前台阻塞

⚠️ 容易踩的坑：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

日志文件路径不存在 → 写入失败，nohup.out 默认生成在当前目录，容易被清理
脚本里用了相对路径（如 require 'vendor/autoload.php'）→ 守护后工作目录是启动时的路径，不是脚本所在目录
没做内存/超时控制 → 图像批量生成可能 OOM，进程被系统 OOM Killer 杀掉，nohup 也救不了

pcntl_fork + posix_setsid 实现真守护，但别裸写

手动 fork 两次、posix_setsid()、chdir('/')*、umask(0)、关闭 STDIN/STDOUT/STDERR……这些步骤没错，但生产环境不建议自己拼：

PHP 8.4+ 已废弃部分 pcntl 信号行为，pcntl_signal_dispatch() 在某些 SAPI 下不可靠
没处理子进程崩溃后的自动拉起 → 一次 GD 内存溢出，整个服务就静默死亡
缺少进程健康检查（比如检测子进程是否卡死在 imagick->writeImage()）

如果你坚持手写，至少补上这三件事：

用 pcntl_signal(SIGTERM, ...) 和 pcntl_signal_dispatch() 响应优雅退出，确保图像写完再 exit
主循环内加 pcntl_waitpid(-1, $status, WNOHANG) 防止僵尸子进程（尤其调用 exec('python gen.py') 时）
所有路径用 <strong>DIR</strong> 或 dirname(<strong>FILE</strong>) 显式指定，别信 getcwd()

Supervisor 才是文生图守护的实用底线

它不改 PHP 代码，不碰 fork，只做一件事：盯住你的进程，死了就拉起来，还能管日志轮转、资源限制、启动顺序。配置示例：

[program:img-generator]
command=php /var/www/app/generate.php
directory=/var/www/app
user=www-data
autostart=true
autorestart=true
startretries=3
stopwaitsecs=30
redirect_stderr=true
stdout_logfile=/var/log/supervisor/imggen.log
stdout_logfile_maxbytes=10MB
environment=PATH="/usr/local/bin:/usr/bin:/bin"

重点说明：

stopwaitsecs=30 给 PHP 留足时间完成最后一张图（比如你在 register_shutdown_function() 里 flush buffer）
environment 补全 PATH，避免调用 convert 或 python 时找不到命令
stdout_logfile_maxbytes 防止日志撑爆磁盘（文生图 debug 输出往往很多）
不要用 root 启动 → Imagick 读写文件权限、临时目录安全都成问题