PHP 开发人员主管指南

Supervisor：用于 PHP 应用程序的强大流程控制系统

Supervisor 是管理后台进程的强大工具，是 PHP 开发人员处理长时间运行的任务、队列工作人员和其他后台作业的必需品。 本指南详细介绍了 Supervisor 设置、PHP 应用程序集成以及实现最佳性能的全面配置。

理解主管

Supervisor 擅长通过以下方式管理后台任务：

• 自动重新启动崩溃的进程。
• 集中日志记录，更容易监控。
• 命令行和 Web 界面控制。

这对于使用以下内容的 PHP 项目特别有利：

• 用于异步处理的 Laravel 队列。
• 持久进程，如 WebSocket 服务器。
• 类似于 cron 作业的计划任务。

安装主管

Ubuntu/Debian：

sudo apt update
sudo apt install supervisor

CentOS/RedHat：

sudo yum install epel-release
sudo yum install supervisor

安装后，激活并启用Supervisor：

sudo systemctl start supervisord
sudo systemctl enable supervisord

主管配置

Supervisor 利用配置文件（通常位于 /etc/supervisor/conf.d/ 中）来管理各个程序。

基本配置示例：

使用以下内容创建/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 选项（在 command 指令内）将失败前的重新启动尝试限制为 3 次。

应用配置：

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start my_php_worker:*

详细配置选项

以下是 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

10. stdout_logfile_maxbytes / stderr_logfile_maxbytes：轮转前的最大日志文件大小。默认值：50MB。示例：stdout_logfile_maxbytes=10MB

11. stdout_logfile_backups / stderr_logfile_backups：要保留的轮换日志文件数。默认值：10。示例：stdout_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 队列： 管理 queue:work 命令以实现可靠的作业处理。

   sudo apt update
   sudo apt install supervisor

2. 计划任务：替换 cron 以实现更强大的计划脚本执行。

   sudo yum install epel-release
   sudo yum install supervisor

3. 长时间运行的脚本：管理持久脚本，如 WebSocket 服务器。

   sudo systemctl start supervisord
   sudo systemctl enable supervisord

   自动化 Supervisor 启动

   确保 Supervisor 在系统启动时启动：

   1. 启用 Supervisor 服务：sudo systemctl enable supervisord

   2. 启动服务（如果需要）：sudo systemctl start supervisord

   最佳实践

   • 使用描述性程序名称。
   • 使用 stdout_logfile_maxbytes 和 stdout_logfile_backups 配置日志轮转。
   • 利用environment指令来管理变量。

   结论

   Supervisor 是 PHP 开发人员管理后台进程的必备工具。本指南全面介绍了其安装、配置和实际应用，确保您的 PHP 项目可靠、高效的任务管理。

   以上是PHP 开发人员主管指南的详细内容。更多信息请关注PHP中文网其他相关文章！