rhessing/php-supervisord

docker-php-supervisord

镜像概述

这是一个集成Supervisord的PHP CLI镜像，旨在为Laravel等PHP框架提供稳定的队列Worker运行环境。默认期望Laravel应用挂载到/var/www目录，也可通过自定义命令适配其他PHP应用场景。

核心功能

1. 集成Supervisord实现后台任务进程的启动、监控与自动重启
2. 支持PHP 7.3、7.4、8.0等多个版本（对应不同镜像标签）
3. 通过环境变量灵活配置任务执行命令（COMMAND）和进程数量（PROCESSES）
4. 提供容器shell调试入口，方便PHP代码问题排查

使用场景

1. Laravel框架队列任务（如异步邮件发送、批量数据处理）的后台执行
2. Symfony Messenger等PHP异步消息系统的消息消费
3. PHP应用的容器化调试与任务验证

配置说明

环境变量

• COMMAND：默认值为php /var/www/apps/laravel/artisan queue:work --sleep=3 --tries=3 --daemon，可自定义任务命令
• PROCESSES：默认值为4，可设置并发执行的任务进程数

部署示例

快速运行（默认配置）

sh
docker run -d \
  --name taskrunner \
  --mount type=bind,source="$(pwd)"/www,target=/var/www \
  rhessing/php-supervisord

调整进程数量

sh
docker run -d \
  --name taskrunner \
  -e PROCESSES=8 \
  --mount type=bind,source="$(pwd)"/www,target=/var/www \
  rhessing/php-supervisord

自定义任务命令

sh
docker run -d \
  --name taskrunner \
  -e COMMAND="php /var/www/app/bin/console messenger:consume async --time-limit=3600" \
  --mount type=bind,source="$(pwd)"/app,target=/var/www \
  rhessing/php-supervisord

调试模式（进入容器shell）

sh
docker run -it \
  --rm \
  --name taskrunner \
  --mount type=bind,source="$(pwd)"/app,target=/var/www \
  rhessing/php-supervisord /bin/sh

GitHub仓库

• https://github.com/rhessing/docker-php-supervisord

已安装扩展

bcmath、bz2、Core、ctype、curl、date、dom、exif、fileinfo、filter、ftp、gd、gettext、gmp、hash、iconv、intl、json、libxml、mbstring、mcrypt、mysqli、mysqlnd、openssl、pcre、PDO、pdo_sqlite、Phar、posix、pspell、readline、redis、Reflection、session、shmop、SimpleXML、sodium、SPL、sqlite3、standard、tidy、tokenizer、xml、xmlreader、xmlwriter、zip、zlib