10up/wp-php-fpm-dev

CentOS - wp-php-fpm-dev 镜像文档

概述

该镜像基于wp-php-fpm扩展而来，专注于为使用wp-local-docker-v2开发WordPress项目提供环境。它包含多种开发工具，并配置为将PHP日志输出到stderr，同时支持邮件处理和调试功能。

支持的标签

• 5.6, 7.0, 7.1, 7.2, 7.3, 7.4

其中，5.6至7.1版本基于CentOS 7构建，7.2至7.4版本基于CentOS 8构建。

核心功能与特性

• 开发工具集成：包含git、vim、telnet、strace、wp-cli、nvm/node、composer等常用开发工具
• 日志配置：PHP日志输出到stderr，便于容器日志收集
• 邮件处理：通过MSMTP配置邮件发送，支持连接智能主机（无认证）
• 调试支持：集成Xdebug，默认不加载，可通过环境变量启用
• 灵活挂载：支持将项目文件挂载或通过初始化容器复制到/var/www/html目录

使用场景

适用于使用wp-local-docker-v2开发WordPress项目的场景，作为PHP-FPM运行环境，提供开发所需工具链和调试能力。

使用方法

基本运行

该镜像仅运行php-fpm服务，需确保项目文件位于/var/www/html目录（可通过挂载或初始化容器复制）。基本运行命令示例：

bash
docker run -d --name phpfpm \
  -v /var/www/html:/var/www/html \
  docker.xuanyuan.run/10up/wp-php-fpm-dev

邮件配置

镜像通过MSMTP处理邮件，仅支持连接无需认证的智能主机。需通过以下环境变量配置：

• MAILER_HOST=<邮件服务器主机>
• MAILER_PORT=<邮件服务器端口>

入口脚本将自动完成MSMTP配置。

Xdebug 配置

Xdebug在部分系统上可能影响性能，默认不加载。如需启用，设置环境变量：

bash
ENABLE_XDEBUG=true

构建说明

该项目利用Docker Hub的自定义构建阶段钩子（详见https://docs.docker.com/docker-hub/builds/advanced/%EF%BC%89%E3%80%82%E5%9C%A8Docker Hub设置自动构建时，需创建构建规则，针对master分支为各PHP版本（5.6、7.0、7.1、7.2、7.3、7.4）构建镜像。

支持级别

活跃维护：10up团队积极维护该项目，将持续适配最新WordPress版本。欢迎提交bug报告、功能请求、问题咨询和Pull请求。