登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

程序园 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›属于 PHP 开发者的 Supervisor 实用指南

属于 PHP 开发者的 Supervisor 实用指南

缣移双 昨天 06:32
属于 PHP 开发者的 Supervisor 实用指南

在 PHP 开发中，我们经常需要运行一些后台进程：队列处理、长时间运行的脚本、WebSocket 服务器等。这些进程可能会因为各种原因意外退出，手动重启既麻烦又不可靠。Supervisor 是一个进程控制系统，专门用来解决这类问题——它能够自动管理后台进程，在进程异常退出时自动重启，并提供统一的日志管理。
本文将详细介绍 Supervisor 的安装、配置和使用，帮助您构建更稳定的 PHP 应用。
Supervisor 简介

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

  • 自动重启异常退出的进程
  • 统一管理进程日志输出
  • 提供命令行和 Web 界面进行进程监控和控制
对于 PHP 开发者而言，Supervisor 特别适用于：

  • Laravel 队列处理器
  • 长时间运行的后台脚本（如 WebSocket 服务）
  • 需要持续运行的任务处理程序
安装 Supervisor

Ubuntu/Debian 系统
  1. sudo apt update
  2. sudo apt install supervisor
复制代码
CentOS/RedHat 系统
  1. sudo yum install epel-release
  2. sudo yum install supervisor
复制代码
安装完成后启动并设置开机自启：
  1. sudo systemctl start supervisord
  2. sudo systemctl enable supervisord
复制代码
基本用法

Supervisor 通过配置文件来管理各个程序，配置文件通常存放在 /etc/supervisor/conf.d/ 目录下。
基础配置示例

以下是一个简单的配置示例。假设需要持续运行一个 PHP 脚本，在 /etc/supervisor/conf.d/my_worker.conf 中创建配置文件：
  1. [program:my_worker]
  2. command=php /path/to/worker.php
  3. autostart=true
  4. autorestart=true
  5. stderr_logfile=/var/log/my_worker.err.log
  6. stdout_logfile=/var/log/my_worker.out.log
复制代码
配置完成后，需要让 Supervisor 重新读取配置并启动程序：
  1. sudo supervisorctl reread
  2. sudo supervisorctl update
  3. sudo supervisorctl start my_worker
复制代码
详细配置选项

基础配置

command：指定要执行的命令
  1. command=php /path/to/worker.php
复制代码
autostart：Supervisor 启动时是否自动启动该程序
  1. autostart=true  # 默认值为 true
复制代码
autorestart：程序退出时的重启策略
  1. autorestart=true        # 总是重启
  2. autorestart=false       # 从不重启
  3. autorestart=unexpected  # 仅在异常退出时重启（推荐）
复制代码
user：指定运行程序的系统用户
  1. user=www-data
复制代码
directory：设置程序的工作目录
  1. directory=/path/to/your/app
复制代码
启动和重启控制

startsecs：程序启动后需要保持运行多少秒才算启动成功
  1. startsecs=5  # 默认 1 秒
复制代码
startretries：启动失败时的重试次数
  1. startretries=3  # 默认 3 次
复制代码
exitcodes：哪些退出码被认为是正常退出（不会触发重启）
  1. exitcodes=0,2  # 默认值
复制代码
stopwaitsecs：发送停止信号后等待多少秒再强制杀死进程
  1. stopwaitsecs=10  # 默认 10 秒
复制代码
stopasgroup：停止时是否连同子进程一起停止
  1. stopasgroup=true  # 推荐设置为 true
复制代码
killasgroup：强制杀死时是否连同子进程一起杀死
  1. killasgroup=true  # 推荐设置为 true
复制代码
日志管理

stdout_logfile / stderr_logfile：标准输出和错误输出的日志文件
  1. stdout_logfile=/var/log/my_program.out.log
  2. stderr_logfile=/var/log/my_program.err.log
复制代码
redirect_stderr：是否把错误输出重定向到标准输出
  1. redirect_stderr=true  # 所有输出都记录到一个文件
复制代码
stdout_logfile_maxbytes：日志文件最大大小，超过后会自动轮转
  1. stdout_logfile_maxbytes=50MB  # 默认 50MB
复制代码
stdout_logfile_backups：保留多少个轮转后的日志文件
  1. stdout_logfile_backups=10  # 默认 10 个
复制代码
环境变量和优先级

environment：配置环境变量
  1. environment=APP_ENV="production",DB_HOST="localhost",REDIS_HOST="127.0.0.1"
复制代码
priority：设置启动优先级，数值越小优先级越高
  1. priority=100  # 默认值为 999
复制代码
实际应用场景

管理 Laravel 队列处理器

Laravel 队列处理是 Supervisor 最常见的应用场景：
  1. [program:laravel_queue_worker]
  2. command=php /var/www/html/artisan queue:work --sleep=3 --tries=3 --max-time=3600
  3. directory=/var/www/html
  4. autostart=true
  5. autorestart=true
  6. user=www-data
  7. numprocs=2
  8. redirect_stderr=true
  9. stdout_logfile=/var/log/laravel_queue_worker.log
  10. stopwaitsecs=3600
复制代码
配置说明：

  • numprocs=2：同时运行 2 个队列处理进程
  • --max-time=3600：每小时重启一次，避免内存泄漏
  • stopwaitsecs=3600：停止时等待足够时间让当前任务完成
运行定时任务

需要注意：Supervisor 不是 cron 的替代品，它是进程管理器。如果你需要定时执行任务，应该：

  • 用 cron 调用一次性脚本，或者
  • 写一个循环脚本用 Supervisor 管理
循环脚本示例：
  1. [program:task_scheduler]
  2. command=php /var/www/html/task_scheduler.php
  3. directory=/var/www/html
  4. autostart=true
  5. autorestart=true
  6. user=www-data
  7. stdout_logfile=/var/log/task_scheduler.log
  8. stderr_logfile=/var/log/task_scheduler_error.log
复制代码
管理 WebSocket 服务器

长时间运行的 WebSocket 服务：
  1. [program:websocket_server]
  2. command=php /var/www/html/websocket_server.php
  3. directory=/var/www/html
  4. autostart=true
  5. autorestart=true
  6. user=www-data
  7. stdout_logfile=/var/log/websocket_server.log
  8. stderr_logfile=/var/log/websocket_server_error.log
  9. stopasgroup=true
  10. killasgroup=true
复制代码
多进程配置

如果需要运行多个相同的进程：
  1. [program:multi_worker]
  2. command=php /var/www/html/worker.php
  3. directory=/var/www/html
  4. autostart=true
  5. autorestart=true
  6. user=www-data
  7. numprocs=4
  8. process_name=%(program_name)s_%(process_num)02d
  9. stdout_logfile=/var/log/worker_%(process_num)02d.log
复制代码
这会创建 4 个进程：multi_worker_00、multi_worker_01、multi_worker_02、multi_worker_03。
常用命令
  1. # 查看所有程序状态
  2. sudo supervisorctl status
  4. # 启动程序
  5. sudo supervisorctl start program_name
  7. # 停止程序
  8. sudo supervisorctl stop program_name
  10. # 重启程序
  11. sudo supervisorctl restart program_name
  13. # 重新读取配置文件
  14. sudo supervisorctl reread
  16. # 应用配置变更
  17. sudo supervisorctl update
  19. # 查看程序输出（类似 tail -f）
  20. sudo supervisorctl tail program_name
  22. # 清空日志
  23. sudo supervisorctl clear program_name
复制代码
开机自启设置

确保系统重启后 Supervisor 能自动启动：
  1. # 设置开机自启
  2. sudo systemctl enable supervisord
  4. # 启动服务（如果还没启动的话）
  5. sudo systemctl start supervisord
  7. # 检查状态
  8. sudo systemctl status supervisord
复制代码
实用技巧

日志轮转配置

为了避免日志文件过大，建议这样配置：
  1. stdout_logfile_maxbytes=50MB
  2. stdout_logfile_backups=5
  3. stderr_logfile_maxbytes=50MB
  4. stderr_logfile_backups=5
复制代码
环境变量管理

对于需要不同环境变量的程序：
  1. environment=APP_ENV="production",
  2.             DB_HOST="localhost",
  3.             DB_PORT="3306",
  4.             REDIS_HOST="127.0.0.1"
复制代码
优雅停止

对于需要优雅停止的程序（比如正在处理任务的队列处理器）：
  1. stopsignal=QUIT
  2. stopwaitsecs=60
  3. stopasgroup=true
  4. killasgroup=true
复制代码
监控和调试

Web 界面

Supervisor 提供了一个简单的 Web 界面，在主配置文件 /etc/supervisor/supervisord.conf 中启用：
  1. [inet_http_server]
  2. port=127.0.0.1:9001
  3. username=admin
  4. password=your_password
复制代码
然后重启 Supervisor，就可以通过 http://localhost:9001 访问管理界面。
日志查看
  1. # 实时查看程序输出
  2. sudo supervisorctl tail -f program_name
  4. # 查看错误日志
  5. sudo supervisorctl tail -f program_name stderr
复制代码
常见问题排查

程序启动失败

  • 检查命令路径是否正确（使用绝对路径）
  • 确认运行用户有执行权限
  • 验证工作目录是否存在且可访问
  • 查看错误日志：sudo supervisorctl tail program_name stderr
程序反复重启

  • 检查程序本身是否有问题（手动运行测试）
  • 适当增加 startsecs 值，给程序更多启动时间
  • 检查 exitcodes 配置，确保正常退出码不会触发重启
无法停止程序

  • 检查程序是否正确处理信号（SIGTERM）
  • 增加 stopwaitsecs 值
  • 设置 stopasgroup=true 和 killasgroup=true
日志相关问题

  • 日志目录权限问题：确保运行用户可写入日志目录
  • 日志文件过大：设置合理的 stdout_logfile_maxbytes
  • 日志轮转：配置 stdout_logfile_backups 数量
总结

Supervisor 是 PHP 开发者管理后台进程的重要工具。无论是 Laravel 队列处理、长时间运行的服务，还是其他需要持续运行的程序，都可以通过 Supervisor 实现稳定运行和自动恢复。
成功使用 Supervisor 的关键在于根据具体应用场景合理配置各项参数，特别要注意日志管理、重启策略和优雅停止等方面的设置。正确配置后，您的 PHP 应用将能够实现 24×7 稳定运行。
原文链接-属于 PHP 开发者的 Supervisor 实用指南

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
属于PHP开发者Supervisor实用

使用道具 举报

相关推荐
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
缣移双
昨天 06:32

0

粉丝关注

16

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫