---
title: WordPress PHP 参数配置（Docker 部署）
description: WordPress PHP 参数配置文档，详细介绍了在使用 Docker 部署 …
url: "https://brimflow.xyz/docs/operations/docker-wordpress-php-config/"
updated: "2025-06-09"
category: 运维
---

# 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](https://wordpress.org/)