Supervisor监控PHP常驻进程教程

在宝塔面板中部署WebSocket服务、消息队列消费者等PHP常驻进程时，常面临意外退出后无法自动恢复的痛点；本文详解如何通过Supervisor插件实现一键式进程守护——从图形化安装配置、命令行备用方案，到状态验证、日志排查及PHP脚本适配优化（如禁用超时、构建循环监听、支持优雅退出），手把手教你打造高可用、自愈型的长期运行环境，让关键业务脚本真正“永不下线”。

如果您在宝塔面板中部署了需长期运行的 PHP 脚本（如 WebSocket 服务、消息队列消费者或定时任务守护进程），但发现其意外退出后未自动重启，则可借助 Supervisor 实现进程的持续监控与自动拉起。以下是具体实施步骤：

一、确认并安装 Supervisor 插件

Supervisor 并非宝塔面板默认内置组件，需通过宝塔软件商店安装对应插件以获得图形化管理界面。安装后，插件将提供进程配置、状态查看及启停控制功能。

1、登录宝塔面板后台，点击左侧菜单栏“软件商店”。

2、在搜索框中输入 Supervisor，找到官方认证的“Supervisor 进程管理器”插件。

3、点击“安装”，等待状态显示为“已安装”且运行状态为“正在运行”。

二、创建 Supervisor 监控配置项

每个需守护的 PHP 进程必须单独定义一个 Supervisor 配置，指定执行路径、用户权限、启动命令及自动重启策略，确保异常退出时能按预设逻辑恢复运行。

1、进入“Supervisor 进程管理器”插件主界面，点击右上角“添加进程”按钮。

2、在“进程名称”栏填写唯一标识名，例如 php-websocket-server。

3、在“启动命令”栏填入完整可执行命令，例如 /www/server/php/82/bin/php /www/wwwroot/example.com/server.php。

4、设置“运行目录”为脚本所在路径，例如 /www/wwwroot/example.com。

5、选择“运行用户”为 www（推荐，避免 root 权限风险）。

6、勾选“开机自启”与“进程异常退出时自动重启”选项。

三、使用命令行手动配置 Supervisor（备用方案）

若插件无法使用或需精细控制，可直接编辑 Supervisor 主配置文件，通过 systemd 管理服务，适用于熟悉 Linux 终端操作的用户。

1、执行 sudo bt 19 命令打开宝塔命令行工具，选择“Supervisor 管理”进入交互模式。

2、选择“添加进程”，按提示依次输入进程名、命令路径、工作目录、用户等参数。

3、配置完成后，执行 supervisorctl reread 重新加载配置。

4、执行 supervisorctl update 应用新增配置。

5、执行 supervisorctl start php-websocket-server 启动指定进程。

四、验证进程运行状态与日志输出

Supervisor 提供实时状态反馈与标准输出/错误日志记录，用于确认进程是否真正驻留并排查启动失败原因。

1、在插件界面查看目标进程的“状态”列，正常应显示为 RUNNING。

2、点击进程右侧“日志”按钮，查看最近 100 行 stdout 输出，确认 PHP 脚本已初始化完成。

3、手动终止进程：执行 kill -9 $(pgrep -f "server.php")，观察 5 秒内状态是否自动变回 RUNNING。

4、检查错误日志路径，通常位于 /www/wwwlogs/supervisor/进程名_stderr.log，定位致命错误信息。

五、调整 PHP 脚本以适配常驻运行环境

普通 CLI PHP 脚本可能依赖一次性执行上下文，需修改为循环监听模式，并禁用超时与内存限制，防止被 Supervisor 误判为异常退出。

1、在脚本开头添加 ini_set('max_execution_time', 0); 和 ini_set('memory_limit', '-1');。

2、使用 while (true) { ... sleep(1); } 构建主循环，避免脚本自然结束。

3、捕获 SIGTERM 信号实现优雅退出，例如注册 pcntl_signal(SIGTERM, function() { exit(0); });。

4、每次循环体中调用 pcntl_signal_dispatch(); 处理挂起信号。

终于介绍完啦！小伙伴们，这篇关于《Supervisor监控PHP常驻进程教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！