arivum/wordpress

WordPress扩展镜像文档

镜像概述与主要用途

本镜像基于官方WordPress镜像扩展而来，继承了WordPress内容管理系统的核心功能（如插件、小部件、主题支持），同时增加了多项实用特性，适用于需要自定义配置、优化性能或集成LDAP认证的WordPress部署场景。

核心功能与特性

• 邮件配置支持：通过环境变量配置php邮件功能，满足邮件发送需求
• 自定义上传大小：可通过环境变量设置最大上传文件大小，灵活适配不同场景
• 轻量Web服务器：使用Caddy代替Apache，且基于Alpine Linux构建，镜像体积更小
• 启动性能优化：避免官方镜像的启动时复制机制，提升启动效率
• LDAP认证支持：包含php-ldap模块，可配合LDAP认证插件使用
• 卷挂载支持：默认提供插件目录（/var/www/html/wp-content/plugins）和上传目录（/var/www/html/wp-content/uploads）卷挂载，便于数据持久化

使用场景与适用范围

适用于需要以下功能的WordPress部署：

• 自定义邮件服务配置
• 调整文件上传大小限制
• 集成LDAP认证系统
• 追求更小镜像体积和更高启动性能
• 需要插件和上传文件持久化存储

使用方法与配置说明

基本使用示例

本镜像使用方式与官方WordPress镜像类似，基础启动命令如下（需链接MySQL容器）：

bash
$ docker run --name some-wordpress --link some-mysql:mysql -d [镜像名称]

环境变量配置

本镜像特有环境变量

继承自官方镜像的环境变量

以下环境变量用于配置WordPress实例，与官方镜像兼容：

• WORDPRESS_DB_HOST：数据库主机（默认链接的mysql容器的IP和端口）
• WORDPRESS_DB_USER：数据库用户（默认root）
• WORDPRESS_DB_PASSWORD：数据库密码（默认链接的mysql容器的MYSQL_ROOT_PASSWORD值）
• WORDPRESS_DB_NAME：数据库名称（默认wordpress）
• WORDPRESS_TABLE_PREFIX：数据库表前缀（默认空，需自定义时设置）
• 安全密钥相关：WORDPRESS_AUTH_KEY、WORDPRESS_SECURE_AUTH_KEY、WORDPRESS_LOGGED_IN_KEY、WORDPRESS_NONCE_KEY、WORDPRESS_AUTH_SALT、WORDPRESS_SECURE_AUTH_SALT、WORDPRESS_LOGGED_IN_SALT、WORDPRESS_NONCE_SALT（默认随机生成SHA1值）
• WORDPRESS_DEBUG：调试模式（默认禁用，非空值启用WP_DEBUG）
• WORDPRESS_CONFIG_EXTRA：额外配置（默认空，非空值将直接嵌入wp-config.php，适用于如WP_ALLOW_MULTISITE等高级配置）

注意事项

• 建议参考官方WordPress镜像文档（https://hub.docker.com/_/wordpress/%EF%BC%89%EF%BC%8C%E5%A4%A7%E9%83%A8%E5%88%86%E9%80%82%E7%94%A8%E4%BA%8E%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E7%9A%84%E6%8A%80%E5%B7%A7%E3%80%81%E6%96%B9%E6%B3%95%E5%92%8C%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E5%90%8C%E6%A0%B7%E9%80%82%E7%94%A8%E4%BA%8E%E6%9C%AC%E9%95%9C%E5%83%8F%E3%80%82
• 邮件功能（ssmtp）仅在同时设置WORDPRESS_ADMIN_MAIL_ADDRESS和WORDPRESS_MAILSERVER_HOST时可用。
• WORDPRESS_UPLOAD_SIZE需严格遵循数字+单位格式（如256M、1G），否则可能导致配置无效。