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

PHP 开发人员主管指南

霞舞

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

原创

1085人浏览过

php 开发人员主管指南

Supervisor是一个功能强大的进程控制系统，广泛应用于后台进程管理。对于PHP开发者而言，经常需要处理长时间运行的进程、队列任务和其他后台作业，Supervisor能够简化这一过程，确保进程持续运行，并在进程异常终止时自动重启，同时提供便捷的监控和管理功能。

本文将指导您如何配置和使用Supervisor管理PHP应用程序，并讲解如何利用其各项功能选项优化效率。

什么是Supervisor？

Supervisor是一个进程控制系统，主要功能包括：

自动重启崩溃的进程。
提供统一的日志记录机制。
通过命令行或Web界面进行进程控制。

Supervisor尤其适用于以下PHP应用场景：

立即学习“PHP免费学习笔记（深入）”；

Laravel后台任务队列。
长时间运行的脚本，例如WebSocket服务器。
定时任务（类似cron）。

安装Supervisor

Ubuntu/Debian系统

<code class="bash">sudo apt update
sudo apt install supervisor</code>

登录后复制

CentOS/Red Hat系统

<code class="bash">sudo yum install epel-release
sudo yum install supervisor</code>

登录后复制

安装完成后，启动并启用Supervisor服务：

<code class="bash">sudo systemctl start supervisord
sudo systemctl enable supervisord</code>

登录后复制

Supervisor基础配置

Supervisor使用配置文件（通常位于/etc/supervisor/conf.d/目录下）管理各个程序。

基本配置示例

以下是一个管理PHP工作进程的简单配置文件示例。在/etc/supervisor/conf.d/目录下创建一个名为my_php_worker.conf的文件，并添加以下内容：

<code class="ini">[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</code>

登录后复制

--tries=3选项指定进程在判定任务失败前最多重试3次。

应用配置更改：

<code class="bash">sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start my_php_worker:*</code>

登录后复制

Supervisor常用配置选项

以下是Supervisor常用配置选项及其示例：

智谱AI开放平台

智谱AI大模型开放平台-新一代国产自主通用AI开放平台

查看详情

1. command: 指定要执行的命令。示例：

<code class="ini">command=php /path/to/worker.php</code>

登录后复制

2. autostart: Supervisor启动时是否自动启动程序。值： true (默认), false 示例：

<code class="ini">autostart=true</code>

登录后复制

3. autorestart: 是否自动重启程序。值： true, false, unexpected 示例：

<code class="ini">autorestart=unexpected</code>

登录后复制

4. startsecs: 进程必须保持运行的时间（秒），才能被视为成功启动。默认值： 1 示例：

<code class="ini">startsecs=5</code>

登录后复制

5. startretries: 进程被标记为失败前允许的重启次数。默认值： 3 示例：

<code class="ini">startretries=5</code>

登录后复制

6. exitcodes: 不会触发重启的可接受退出代码列表。默认值： 0,2 示例：

<code class="ini">exitcodes=0,1</code>

登录后复制

7. stopwaitsecs: 发送停止信号后，强制终止进程前等待的时间（秒）。默认值： 10 示例：

<code class="ini">stopwaitsecs=20</code>

登录后复制

8. redirect_stderr: 将标准错误输出重定向到与标准输出相同的日志文件。值： true, false (默认) 示例：

<code class="ini">redirect_stderr=true</code>

登录后复制

9. stdout_logfile / stderr_logfile: 标准输出和标准错误日志文件路径。示例：

<code class="ini">stdout_logfile=/var/log/my_program.out.log
stderr_logfile=/var/log/my_program.err.log</code>

登录后复制

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

<code class="ini">stdout_logfile_maxbytes=10MB
stderr_logfile_maxbytes=5MB</code>

登录后复制

11. stdout_logfile_backups / stderr_logfile_backups: 要保留的轮转日志文件数量。默认值： 10 示例：

<code class="ini">stdout_logfile_backups=3
stderr_logfile_backups=3</code>

登录后复制

12. user: 运行程序的用户。示例：

<code class="ini">user=www-data</code>

登录后复制

13. environment: 定义程序的环境变量。示例：

<code class="ini">environment=app_env="production",db_host="localhost"</code>

登录后复制

14. priority: 控制程序启动顺序，数值越小越先启动。默认值： 999 示例：

<code class="ini">priority=100</code>

登录后复制

15. directory: 指定程序的工作目录。示例：

<code class="ini">directory=/path/to/your/app</code>

登录后复制

16. stopasgroup: 向程序及其子进程发送停止信号。值： true, false (默认) 示例：

<code class="ini">stopasgroup=true</code>

登录后复制

17. killasgroup: 如果程序及其子进程在stopwaitsecs后仍未停止，则向它们发送终止信号。值： true, false (默认) 示例：

<code class="ini">killasgroup=true</code>

登录后复制

PHP开发者应用场景

1. 管理Laravel队列

Laravel的queue:work命令用于处理队列任务。Supervisor可以确保这些工作进程持续运行。

配置示例：

<code class="ini">[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</code>

登录后复制

2. 运行定时任务

对于需要定期执行的脚本，Supervisor比cron更可靠。

配置示例：

<code class="ini">[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</code>

登录后复制

3. 长时间运行的脚本

使用Supervisor管理WebSocket服务器或其他持久化运行的脚本。

配置示例：

<code class="ini">[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</code>

登录后复制

设置Supervisor在系统启动时自动启动

要确保Supervisor在系统启动时自动运行，请执行以下步骤：

1. 启用Supervisor服务在系统启动时自动启动：

<code class="bash">sudo systemctl enable supervisord</code>

登录后复制

2. 启动Supervisor服务（如果尚未运行）：

<code class="bash">sudo systemctl start supervisord</code>

登录后复制

最佳实践

使用具有描述性的程序名称。
配置stdout_logfile_maxbytes和stdout_logfile_backups实现日志轮转。
使用environment传递环境变量。

结论

Supervisor是PHP开发者管理后台任务的强大工具。本文介绍了Supervisor的安装、配置以及在实际应用中的案例。无论您是运行Laravel队列、定时任务还是长时间运行的进程，Supervisor都能确保其可靠性和易用性。

以上就是PHP 开发人员主管指南的详细内容，更多请关注php中文网其它相关文章！