用于WordPress的轻量级PHP-FPM & Nginx Docker镜像

镜像概述和主要用途

这是一个维护中的仓库，我们在生产环境中使用此项目，并推荐用于你的项目。该容器不包含MySQL或邮件服务，需从外部（其他容器或主机）提供。项目采用模块化设计，力求运行时最小化，仅包含必要组件，提升Docker使用体验和安全性。

核心功能和特性

• 轻量级运行环境：包含php7.xx、php-fpm7、nginx和wp-cli，满足WordPress运行需求
• 邮件支持：集成msmtp，可通过SMTP服务器发送邮件
• 灵活的项目布局：支持自定义项目路径，兼容bedrock布局
• 用户权限控制：可通过环境变量设置Web用户和组ID，避免以root运行
• Nginx自定义配置：支持项目内Nginx配置文件的包含，灵活扩展
• Cron任务支持：可在项目中定义Cron任务，自动运行
• 环境变量配置：支持时区、开发/生产环境、数据库、邮件等多方面配置

使用场景和适用范围

适用于需要部署WordPress的环境，尤其是追求轻量级、模块化和可定制化的生产环境。适合与外部MySQL/MariaDB容器、邮件服务器配合使用，支持CI/CD流程（如Drone CI测试）及自定义项目结构。

详细使用方法和配置说明

容器布局

项目挂载路径

将WordPress项目挂载至：

/var/www/project

Web根目录

项目的Web根目录需定义在：

/var/www/project/web

Nginx将从此目录提供请求，与bedrock布局兼容。

自定义项目路径

可通过OVERRIDE_PROJECT_ROOT环境变量更改项目路径。容器会创建从/var/www/project到$OVERRIDE_PROJECT_ROOT的符号链接，实现自定义路径。

示例：在Drone CI中，所有挂载位于/drone/src，可设置OVERRIDE_PROJECT_ROOT=/drone/src/project进行测试。

用户权限

通过WP_GID和WP_UID环境变量设置Web用户和组ID。若未设置，容器会检查/var/www/project/web/中挂载文件的所有者和组：

• 若文件所有者/组为root，则自动使用100:101作为权限（避免以root运行nginx和php-fpm）
• 否则使用文件的所有者:组作为权限

Nginx配置包含

项目挂载路径/var/www/project/nginx中可放置自定义Nginx配置文件，按以下规则包含：

• 包含至http {}块：/var/www/project/nginx/http/*.conf
• 包含至server {}块：/var/www/project/nginx/server/*.conf
• 包含至@index {}块：/var/www/project/nginx/index/*.conf

更多信息可参考wp-project模板。

Cron任务

在项目中放置Cron文件/var/www/project/tasks.cron，容器会将其符号链接至crond，并以wordpress用户运行。

示例：

# 每日/每周/每月维护任务
*       *       *       *       *       echo "测试日志来自: $(whoami)..." >> /tmp/test.log

环境变量

时区

设置环境和PHP的时区（可选值见PHP时区列表）：

TZ     # 默认: 'Europe/Helsinki'

开发/生产环境

WP_ENV # 默认: '' 可选值: development, testing, production 等自定义值

数据库变量（MySQL/MariaDB）

DB_NAME     # 默认: ''
DB_PASSWORD # 默认: ''
DB_USER     # 默认: ''
DB_HOST     # 默认: ''
DB_PORT     # 默认: ''

需设置DB_NAME、DB_PASSWORD和DB_USER，并在wp-config.php中使用这些变量，它们会自动添加到PHP环境变量中。

邮件变量

SMTP_HOST  # SMTP服务器主机，默认尝试连接Docker主机172.17.0.1
SMTP_PORT  # SMTP端口，默认25
SMTP_TLS   # 若提供，使用TLS认证
SMTP_USER  # SMTP用户名，若提供则启用认证
SMTP_PASSWORD # SMTP密码，若提供则启用认证
SMTP_AUTH  # 认证模式，默认'off'，当提供SMTP_USER和SMTP_PASSWORD时自动激活

PHP和Nginx变量

# PHP内存限制、Nginx请求体大小、FastCGI超时
PHP_MEMORY_LIMIT=128M               # 默认: 128M
NGINX_MAX_BODY_SIZE=64M             # 默认: 64M
NGINX_FASTCGI_TIMEOUT=30            # 默认: 30

# PHP 7.3默认值
NGINX_CACHE_DIRECTORY=/dev/cache    # 默认FastCGI缓存目录
# 缓存过期时的操作
NGINX_CACHE_USE_STALE="error timeout invalid_header updating http_500 http_503 http_403 http_404 http_429"
# Redis缓存TTL默认值
NGINX_REDIS_CACHE_TTL_DEFAULT="200 301 302 1m"
# 缓存控制头
NGINX_CACHE_CONTROL='"max-age=60, stale-while-revalidate=300, stale-if-error=21600"'
CACHE_QUERYVARS=                     # 缓存请求中包含的查询参数，逗号分隔，默认空
CACHE_MODE=                         # 缓存模式，默认'whitelist'，可选'blacklist'或'whitelist'

容器包含组件

运行WordPress所需

• php7.xx
• php-fpm7
• nginx
• wp-cli

邮件发送

• msmtp（用于通过SMTP服务器发送邮件）