WordPress PHP 参数配置（Docker 部署）

WordPress PHP 参数配置文档，详细介绍了在使用 Docker 部署 WordPress 官方 Apache 镜像时，如何通过 .htaccess 文件配置 PHP 参数，包括内存限制、文件上传大小等。

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

1. 停止 WordPress 容器 #

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

Bash

sudo docker compose stop <wordpress-service-name>

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

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

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

YAML

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

此时本地路径为 ./wordpress-html，编辑 .htaccess 文件：

Bash

sudo nano ./wordpress-html/.htaccess

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

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

Apache

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 文件，并将配置内容包裹在以下区域内：

Apache

# BEGIN WordPress
...
# END WordPress

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

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

Bash

sudo docker compose start <wordpress-service-name>

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

WordPress PHP 参数配置到此完成，进入 WordPress 后台 → 工具 → 站点健康，查看 PHP 信息部分，确认以下参数是否已生效：

memory_limit
upload_max_filesize
post_max_size
max_execution_time
max_input_time

WordPress.org