mdobak/php-common-stack

PHP Common Stack

包含cron、composer和supervisor的Docker镜像，基于官方PHP镜像构建 💪
https://github.com/MDobak/php-common-stack

镜像概述

PHP Common Stack是基于官方PHP镜像构建的Docker镜像，集成了Cron、Composer和Supervisor工具，提供了便捷的PHP扩展管理能力，支持在运行中容器内动态配置PHP扩展、管理定时任务和进程监控，适用于各类需要PHP环境的应用部署。

核心功能与特性

• PHP扩展管理工具：提供docker-pcs-php-ext-config、docker-pcs-php-ext-enable/disable等工具，支持动态配置、启用/禁用PHP扩展
• Composer集成：内置Composer包管理工具，方便PHP项目依赖管理
• Cron支持：支持添加自定义定时任务，兼容Debian和Alpine系统的不同配置方式
• Supervisor集成：支持进程监控和管理，可配置自定义程序
• 调试支持：提供XDebug安装和配置指南，便于本地开发调试

使用场景

• 需要定时任务的PHP应用（如数据同步、定时任务处理）
• 需要进程监控的服务型PHP应用（如队列 worker）
• 本地开发环境，需动态调整PHP配置和扩展
• 基于官方PHP镜像的生产环境部署，需增强管理能力

PHP扩展管理

镜像提供多种工具用于管理PHP扩展，支持在运行中容器内动态配置、启用/禁用扩展：

docker-pcs-php-ext-config

用于编辑PHP扩展配置，自动定位扩展配置文件，支持添加、修改和删除配置项。

添加/修改配置：

bash
docker-pcs-php-ext-config opcache \
    opcache.memory_consumption=512 \
    opcache.interned_strings_buffer=8 \
    opcache.max_accelerated_files=10000 \
    opcache.revalidate_freq=0 \
    opcache.fast_shutdown=1 \
    opcache.enable_cli=1 \
    opcache.enable=1

删除配置：

bash
docker-pcs-php-ext-config opcache \
    --rm opcache.memory_consumption \
    --rm opcache.interned_strings_buffer

编辑php.ini文件：

bash
touch /usr/local/etc/php/php.ini  # 确保php.ini文件存在
docker-pcs-php-ext-config php --ini-name ../php.ini \
    log_errors=On \
    access_log=/dev/stdout \
    error_log=/dev/stderr

--ini-name参数指定的路径相对于/usr/local/etc/php/conf.d/目录。在运行中容器上，可添加--restart参数自动重启PHP进程。

docker-pcs-php-ext-enable/disable

类似phpenmod和phpdismod，用于启用/禁用PHP扩展，支持--restart参数自动重启PHP进程。

docker-pcs-php-ext-install

类似docker-php-ext-install，但当镜像未提供扩展源码时会回退到pecl安装，并自动启用扩展。

docker-pcs-php-restart

重启FPM或Apache进程以重新加载配置。

安装PHP扩展的详细说明可参考https://hub.docker.com/_/php/%E3%80%82

使用XDebug调试容器

本地开发时，可创建包含XDebug的自定义Dockerfile：

dockerfile
FROM mdobak/php-common-stack:fpm-alpine

# 自定义配置

RUN    docker-pcs-php-ext-install xdebug \
    && docker-pcs-php-ext-config xdebug \
           xdebug.remote_enable=1 \
           xdebug.remote_autostart=1 \
           xdebug.remote_host=172.17.0.1  # Linux宿主机IP
           # xdebug.remote_host=docker.for.mac.localhost  # macOS宿主机

XDebug会显著降低PHP执行速度，建议按需启用/禁用：

• 通过容器root shell执行docker-pcs-php-ext-enable/disable xdebug
• 或使用docker exec命令：docker exec 容器名称 docker-pcs-php-ext-disable xdebug

也可禁用xdebug.remote_autostart并通过Cookie管理XDebug，但此方式无法调试cron和supervisor脚本。
更多XDebug信息参见官方文档。

添加自定义Cron任务

• Debian镜像：在/etc/cron.d/目录添加crontab格式文件，或直接编辑/etc/crontab文件
• Alpine镜像：仅支持在/etc/crontab/目录添加crontab格式文件

添加自定义Supervisor程序

需添加Supervisord配置文件，存放路径因系统而异：

• Debian镜像：/etc/supervisor/conf.d/
• Alpine镜像：/etc/supervisor.d/

上述目录中存在默认supervisord.conf文件，注意不要覆盖。

最简Supervisor配置示例：

ini
[program:my_app]
command = /var/www/html/bin/console my:worker  # 程序启动命令
stdout_logfile = /dev/stdout  # 标准输出日志
stdout_logfile_maxbytes = 0  # 不限制日志大小
stderr_logfile = /dev/stderr  # 错误输出日志
stderr_logfile_maxbytes = 0  # 不限制日志大小

更多Supervisord信息参见官方文档。

更多信息

本镜像基于官方PHP Docker镜像构建，更多细节可参考https://hub.docker.com/_/php/%E3%80%82