PHP 开发人员主管指南-php教程-PHP中文网

PHP 开发人员主管指南

霞舞

发布： 2025-01-20 14:49:51

原创

1008人浏览过

php 开发人员主管指南

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

登录后复制