构建含supervisor的
php
运行容器是为了提升应用稳定性并实现进程自动重启;1.使用
docker
file构建镜像,基于php:8.1-fpm-alpine安装supervisor及必要php扩展;2.配置supervisord.conf文件监控php-fpm和后台任务进程;3.通过docker build和docker run命令构建并运行容器;调试时可查看日志、进入容器执行脚本、使用supervisorctl控制进程,并结合xdebug进行远程调试;supervisor重启策略包括false、true、unexpected三种,分别适用于一次性任务、持续任务和非预期退出场景;优雅停止需在
php脚本
中注册sigterm信号处理函数,配合supervisor配置stopsignal和stopwaitsecs参数实现进程安全退出。
简单来说,构建含Supervisor的PHP运行容器,就是为了让你的PHP应用在容器里更稳定、更可靠地运行,特别是那些需要长时间运行的后台任务。Supervisor能帮你监控这些进程,一旦挂掉就自动重启。
解决方案:
首先,你需要一个Dockerfile。这个文件定义了你的容器镜像的构建步骤。
立即学习
“
PHP免费学习笔记(深入)
”;
接下来,你需要一个
文件,用来配置Supervisor。这个文件定义了你需要监控的进程以及如何监控。
构建镜像:
运行容器:
这样,你的PHP应用就在一个包含Supervisor的容器里运行起来了。 Supervisor会监控你的PHP-FPM进程和你的后台任务,并在它们崩溃时自动重启。
如何调试Supervisor管理的PHP进程?
调试Supervisor管理的PHP进程,其实和调试一般的PHP应用类似,但需要注意一些细节。
日志先行
: Supervisor的配置文件里,
和
定义了进程的标准输出和标准错误输出的日志文件。首先检查这些日志文件,看看是否有任何错误信息或异常堆栈。例如,上面配置中的
。
进入容器
: 使用
进入运行中的容器。然后,你可以手动执行你的PHP脚本,看看是否会报错。例如:
。
Supervisor 控制
: 使用
命令可以控制 Supervisor。例如,
可以查看所有进程的状态,
可以重启指定的进程。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
Xdebug
: 如果你需要更深入的调试,可以使用 Xdebug。首先,确保你的PHP容器里安装了 Xdebug。然后,配置你的IDE(例如 VS Code 或 PHPStorm)连接到容器中的 Xdebug。
远程调试
: 如果你的应用运行在远程服务器上,你需要配置 Xdebug 的远程调试。这需要在
文件中配置 Xdebug 的远程主机和端口。同时,确保你的防火墙允许 IDE 连接到服务器的 Xdebug 端口。
Supervisor重启策略有哪些?如何选择?
Supervisor提供了多种重启策略,主要通过
参数控制。
: 进程退出后不自动重启。这适用于那些只需要运行一次的任务,例如数据库迁移。
: 进程退出后总是自动重启。这是最常用的策略,适用于需要持续运行的后台任务,例如消息队列消费者。
: 只有当进程因为非预期原因退出时才自动重启。例如,如果进程因为内存溢出或代码错误而崩溃,Supervisor会重启它。但是,如果进程因为正常退出(例如调用了
函数),Supervisor就不会重启它。
如何优雅地停止Supervisor管理的PHP进程?
优雅停止是指在停止进程之前,先让进程完成当前正在处理的任务,而不是直接强制停止。这可以避免
数据丢失
或损坏。
信号处理
: 在你的PHP脚本中,注册信号处理函数来捕获
信号。当 Supervisor 发送
信号时,你的脚本可以执行一些清理工作,例如保存未完成的数据、关闭数据库连接等。
Supervisor 配置
: 确保 Supervisor 在停止进程时发送
信号。这是 Supervisor 的默认行为,但最好还是显式地配置一下。
逐步停止
: 如果你需要停止多个进程,可以先停止那些不依赖其他进程的进程,然后再停止那些依赖其他进程的进程。这可以避免出现依赖问题。
超时设置
: Supervisor 提供了
参数,用于设置 Supervisor 在发送
信号后等待进程退出的时间。如果进程在指定的时间内没有退出,Supervisor 就会强制停止它。
FROM php:8.1-fpm-alpine # 选择一个合适的PHP镜像
# 安装 Supervisor
RUN apk update && apk add supervisor
# 安装 PHP 扩展 (根据你的项目需要)
RUN docker-php-ext-install pdo pdo_mysql mysqli
# 设置 Supervisor 配置文件
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
# 设置工作目录
WORKDIR /var/www/html
# 将你的 PHP 代码复制到容器中
COPY . /var/www/html
# 设置容器启动时运行 Supervisor
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/supervisord.conf"]
EXPOSE 9000 # 暴露 PHP-FPM 端口supervisord.conf[supervisord]
nodaemon=false
[program:php-fpm]
command=/usr/local/sbin/php-fpm -F
user=www-data
stdout_logfile=/dev/fd/1
stdout_logfile_maxbytes=0
stderr_logfile=/dev/fd/2
stderr_logfile_maxbytes=0
[program:your_worker]
command=php /var/www/html/your_worker.php # 替换成你的后台任务脚本
user=www-data
stdout_logfile=/var/log/supervisor/your_worker.log
stderr_logfile=/var/log/supervisor/your_worker.log
autostart=true
autorestart=truedocker build -t your-php-app .docker run -d -p 9000:9000 your-php-appstdout_logfilestderr_logfile/var/log/supervisor/your_worker.logdocker exec -it bash php /var/www/html/your_worker.phpsupervisorctlsupervisorctl statussupervisorctl restart your_workerphp.iniautorestartautorestart=falseautorestart=trueautorestart=unexpectedexit()SIGTERMSIGTERMSIGTERM[program:your_worker]
command=php /var/www/html/your_worker.php
stopsignal=TERMstopwaitsecsSIGTERM[program:your_worker]
command=php /var/www/html/your_worker.php
stopsignal=TERM
stopwaitsecs=10