Supervisor是一个功能强大的进程控制系统，广泛应用于后台进程管理。对于PHP开发者而言，经常需要处理长时间运行的进程、队列任务和其他后台作业，Supervisor能够简化这一过程，确保进程持续运行，并在进程异常终止时自动重启，同时提供便捷的监控和管理功能。
本文将指导您如何配置和使用Supervisor管理PHP应用程序，并讲解如何利用其各项功能选项优化效率。
什么是Supervisor？
Supervisor是一个进程控制系统，主要功能包括：
- 自动重启崩溃的进程。
- 提供统一的日志记录机制。
- 通过命令行或Web界面进行进程控制。
Supervisor尤其适用于以下PHP应用场景：
立即学习“PHP免费学习笔记（深入）”；
- Laravel后台任务队列。
- 长时间运行的脚本，例如WebSocket服务器。
- 定时任务（类似cron）。
安装Supervisor
Ubuntu/Debian系统
sudo apt update sudo apt install supervisor
CentOS/Red Hat系统
sudo yum install epel-release sudo yum install supervisor
安装完成后，启动并启用Supervisor服务：
sudo systemctl start supervisord sudo systemctl enable supervisord
Supervisor基础配置
Supervisor使用配置文件（通常位于/etc/supervisor/conf.d/目录下）管理各个程序。
基本配置示例
以下是一个管理PHP工作进程的简单配置文件示例。在/etc/supervisor/conf.d/目录下创建一个名为my_php_worker.conf的文件，并添加以下内容：
[program:my_php_worker] command=php /path/to/worker.php autostart=true autorestart=true stderr_logfile=/var/log/my_php_worker.err.log stdout_logfile=/var/log/my_php_worker.out.log
--tries=3选项指定进程在判定任务失败前最多重试3次。
应用配置更改：
sudo supervisorctl reread sudo supervisorctl update sudo supervisorctl start my_php_worker:*
Supervisor常用配置选项
以下是Supervisor常用配置选项及其示例：
1. command: 指定要执行的命令。
示例：
command=php /path/to/worker.php
2. autostart: Supervisor启动时是否自动启动程序。
值： true (默认), false
示例：
autostart=true
3. autorestart: 是否自动重启程序。
值： true, false, unexpected
示例：
autorestart=unexpected
4. startsecs: 进程必须保持运行的时间（秒），才能被视为成功启动。
默认值： 1
示例：
startsecs=5
5. startretries: 进程被标记为失败前允许的重启次数。
默认值： 3
示例：
startretries=5
6. exitcodes: 不会触发重启的可接受退出代码列表。
默认值： 0,2
示例：
exitcodes=0,1
7. stopwaitsecs: 发送停止信号后，强制终止进程前等待的时间（秒）。
默认值： 10
示例：
stopwaitsecs=20
8. redirect_stderr: 将标准错误输出重定向到与标准输出相同的日志文件。
值： true, false (默认)
示例：
redirect_stderr=true
9. stdout_logfile / stderr_logfile: 标准输出和标准错误日志文件路径。
示例：
stdout_logfile=/var/log/my_program.out.log stderr_logfile=/var/log/my_program.err.log
10. stdout_logfile_maxbytes / stderr_logfile_maxbytes: 日志文件轮转前允许的最大文件大小。
默认值： 50MB
示例：
stdout_logfile_maxbytes=10MB stderr_logfile_maxbytes=5MB
11. stdout_logfile_backups / stderr_logfile_backups: 要保留的轮转日志文件数量。
默认值： 10
示例：
stdout_logfile_backups=3 stderr_logfile_backups=3
12. user: 运行程序的用户。
示例：
user=www-data
13. environment: 定义程序的环境变量。
示例：
environment=app_env="production",db_host="localhost"
14. priority: 控制程序启动顺序，数值越小越先启动。
默认值： 999
示例：
priority=100
15. directory: 指定程序的工作目录。
示例：
directory=/path/to/your/app
16. stopasgroup: 向程序及其子进程发送停止信号。
值： true, false (默认)
示例：
stopasgroup=true
17. killasgroup: 如果程序及其子进程在stopwaitsecs后仍未停止，则向它们发送终止信号。
值： true, false (默认)
示例：
killasgroup=true
PHP开发者应用场景
1. 管理Laravel队列
Laravel的queue:work命令用于处理队列任务。Supervisor可以确保这些工作进程持续运行。
配置示例：
[program:laravel_queue_worker] command=php /path/to/artisan queue:work --tries=3 autostart=true autorestart=true user=www-data stderr_logfile=/var/log/laravel_queue_worker.err.log stdout_logfile=/var/log/laravel_queue_worker.out.log
2. 运行定时任务
对于需要定期执行的脚本，Supervisor比cron更可靠。
配置示例：
[program:send_reminders] command=php /path/to/send_reminders.php autostart=true autorestart=true stderr_logfile=/var/log/send_reminders.err.log stdout_logfile=/var/log/send_reminders.out.log
3. 长时间运行的脚本
使用Supervisor管理WebSocket服务器或其他持久化运行的脚本。
配置示例：
[program:websocket_server] command=php /path/to/websocket_server.php autostart=true autorestart=true stderr_logfile=/var/log/websocket_server.err.log stdout_logfile=/var/log/websocket_server.out.log
设置Supervisor在系统启动时自动启动
要确保Supervisor在系统启动时自动运行，请执行以下步骤：
1. 启用Supervisor服务在系统启动时自动启动：
sudo systemctl enable supervisord
2. 启动Supervisor服务（如果尚未运行）：
sudo systemctl start supervisord
最佳实践
- 使用具有描述性的程序名称。
- 配置
stdout_logfile_maxbytes和stdout_logfile_backups实现日志轮转。 - 使用
environment传递环境变量。
结论
Supervisor是PHP开发者管理后台任务的强大工具。本文介绍了Supervisor的安装、配置以及在实际应用中的案例。无论您是运行Laravel队列、定时任务还是长时间运行的进程，Supervisor都能确保其可靠性和易用性。
