构建含supervisor的php运行容器是为了提升应用稳定性并实现进程自动重启；1.使用dockerfile构建镜像，基于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免费学习笔记（深入）”；
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文件，用来配置Supervisor。这个文件定义了你需要监控的进程以及如何监控。
[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=true
构建镜像：docker build -t your-php-app .
运行容器：docker run -d -p 9000:9000 your-php-app
这样，你的PHP应用就在一个包含Supervisor的容器里运行起来了。 Supervisor会监控你的PHP-FPM进程和你的后台任务，并在它们崩溃时自动重启。
如何调试Supervisor管理的PHP进程？
调试Supervisor管理的PHP进程，其实和调试一般的PHP应用类似，但需要注意一些细节。
-
日志先行: Supervisor的配置文件里，stdout_logfile 和 stderr_logfile 定义了进程的标准输出和标准错误输出的日志文件。首先检查这些日志文件，看看是否有任何错误信息或异常堆栈。例如，上面配置中的/var/log/supervisor/your_worker.log。
-
进入容器: 使用 docker exec -it
bash 进入运行中的容器。然后，你可以手动执行你的PHP脚本，看看是否会报错。例如：php /var/www/html/your_worker.php。 -
Supervisor 控制: 使用 supervisorctl 命令可以控制 Supervisor。例如，supervisorctl status 可以查看所有进程的状态，supervisorctl restart your_worker 可以重启指定的进程。
-
Xdebug: 如果你需要更深入的调试，可以使用 Xdebug。首先，确保你的PHP容器里安装了 Xdebug。然后，配置你的ide（例如 VS Code 或 phpstorm）连接到容器中的 Xdebug。
-
远程调试: 如果你的应用运行在远程服务器上，你需要配置 Xdebug 的远程调试。这需要在 php.ini 文件中配置 Xdebug 的远程主机和端口。同时，确保你的防火墙允许 IDE 连接到服务器的 Xdebug 端口。
Supervisor重启策略有哪些？如何选择？
Supervisor提供了多种重启策略，主要通过autorestart参数控制。
-
autorestart=false: 进程退出后不自动重启。这适用于那些只需要运行一次的任务，例如数据库迁移。
-
autorestart=true: 进程退出后总是自动重启。这是最常用的策略，适用于需要持续运行的后台任务，例如消息队列消费者。
-
autorestart=unexpected: 只有当进程因为非预期原因退出时才自动重启。例如，如果进程因为内存溢出或代码错误而崩溃，Supervisor会重启它。但是，如果进程因为正常退出（例如调用了 exit() 函数），Supervisor就不会重启它。
如何优雅地停止Supervisor管理的PHP进程？
优雅停止是指在停止进程之前，先让进程完成当前正在处理的任务，而不是直接强制停止。这可以避免数据丢失或损坏。
-
信号处理: 在你的PHP脚本中，注册信号处理函数来捕获 SIGTERM 信号。当 Supervisor 发送 SIGTERM 信号时，你的脚本可以执行一些清理工作，例如保存未完成的数据、关闭数据库连接等。
<?php declare(ticks=1); // 必须声明这个才能使用信号处理 function signal_handler($signal) { switch ($signal) { case SIGTERM: echo "收到 SIGTERM 信号，正在清理...n"; // 执行清理工作 exit(0); break; } } pcntl_signal(SIGTERM, 'signal_handler'); while (true) { // 你的任务逻辑 echo "正在处理任务...n"; sleep(1); } ?> -
Supervisor 配置: 确保 Supervisor 在停止进程时发送 SIGTERM 信号。这是 Supervisor 的默认行为，但最好还是显式地配置一下。
[program:your_worker] command=php /var/www/html/your_worker.php stopsignal=TERM
-
逐步停止: 如果你需要停止多个进程，可以先停止那些不依赖其他进程的进程，然后再停止那些依赖其他进程的进程。这可以避免出现依赖问题。
-
超时设置: Supervisor 提供了 stopwaitsecs 参数，用于设置 Supervisor 在发送 SIGTERM 信号后等待进程退出的时间。如果进程在指定的时间内没有退出，Supervisor 就会强制停止它。
[program:your_worker] command=php /var/www/html/your_worker.php stopsignal=TERM stopwaitsecs=10
