Docker WordPress 部署指南：配置 PHP 参数（官方 Apache 镜像）

适用范围 #

本文档仅针对使用 Docker Compose 管理的 WordPress 官方 Apache 镜像容器。如果你的 WordPress 容器基于其他镜像（如 FPM），请查阅相应的 PHP 配置方法。

1. 停止 WordPress 容器 #

修改 .htaccess 前建议先停止 WordPress 容器，防止写入冲突。

sudo docker compose stop <wordpress-service-name>

提示： 将 <wordpress-service-name> 替换为你的 docker-compose.yml 文件中 WordPress 服务的名称（例如，wordpress）。

2. 编辑挂载目录中的 .htaccess #

在 docker-compose.yml 文件中挂载 WordPress 的站点目录：

services:
  wordpress:
    image: wordpress:latest
    volumes:
      - ./wordpress-html:/var/www/html

此时本地路径为 ./wordpress-html，即：

sudo nano ./wordpress-html/.htaccess

提示： 如果 ./wordpress-html 目录下没有 .htaccess 文件，请先创建一个。

3. 设置 PHP 参数（注意位置） #

将以下设置添加至 .htaccess 文件中，请按需要设置相应的值：

php_value memory_limit 256M
php_value upload_max_filesize 128M
php_value post_max_size 128M
php_value max_execution_time 330
php_value max_input_time 330

⚠️ 注意添加到覆盖区域之外 #

WordPress 会自动生成 .htaccess 文件，并将大部分内容包裹在以下区域内：

# BEGIN WordPress
...
# END WordPress

请将自定义的 php_value 设置添加在这个区域之外，否则在后台改动设置时可能被覆盖。

4. 启动容器并验证设置 #

sudo docker compose start <wordpress-service-name>

提示： 将 <wordpress-service-name> 替换为你的 docker-compose.yml 文件中 WordPress 服务的名称（例如，wordpress）。

验证建议 #

进入 WordPress 后台 → 工具 → 站点健康，查看 PHP 信息部分，确认 memory_limit, upload_max_filesize, post_max_size, max_execution_time, max_input_time 等参数是否已生效。

[可选] 也可以创建一个名为 phpinfo.php 的文件，内容如下：

<?php
phpinfo();
?>

将此文件上传到你的 WordPress 站点根目录，通过浏览器访问 your-domain.com/phpinfo.php，查找相关的 PHP 参数值。完成后请删除该文件以确保安全。

有用的链接

WordPress.org: https://wordpress.org/