Supervisor是一个功能强大的进程控制系统,广泛应用于后台进程管理。对于PHP开发者而言,经常需要处理长时间运行的进程、队列任务和其他后台作业,Supervisor能够简化这一过程,确保进程持续运行,并在进程异常终止时,同时提供便捷的监控和管理功能。
本文将指导您如何配置和使用Supervisor管理PHP应用程序,并讲解如何利用其各项功能选项优化效率。
什么是Supervisor?
Supervisor是一个进程控制系统,主要功能包括:
- 自动重启崩溃的进程。
- 提供统一的日志记录机制。
- 通过命令行或Web界面进行进程控制。
Supervisor尤其适用于以下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. stopwtsecs: 发送停止信号后,强制终止进程前等待的时间(秒)。 默认值: 10 示例:
stopwaitsecs=20
8. irect_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都能确保其可靠性和易用性。
以上就是PHP 开发人员主管指南的详细内容,更多请关注php中文网其它相关文章!