想快速搭建一个 WordPress 环境？这篇文章将带你一步步实现：使用 Docker Compose 一键部署 WordPress、MySQL 和 phpMyAdmin，同时支持指定 PHP 版本和自定义 php.ini 配置。

截至 2026 年，WordPress 官方推荐生产环境使用 PHP 8.3 或更高版本，数据库使用 MariaDB 10.11+ 或 MySQL 8.0+。下面的示例面向本地开发和测试环境，生产环境请替换默认密码并使用 HTTPS。

✅ 功能亮点

  • 🚀 一键启动 WordPress + MySQL + phpMyAdmin
  • 🧩 可选 PHP 版本（通过自定义 Dockerfile）
  • ⚙️ 自定义 php.ini 配置
  • 💾 数据持久化保存到本地目录
  • 🔐 所有配置开箱即用

🧱 项目结构

首先，我们建议使用如下目录结构：

1
2
3
4
5
6
7
8
project-root/
├── docker-compose.yml       # 核心 Docker 配置
├── php.ini                  # PHP 自定义设置
├── wordpress/               # WordPress Dockerfile 存放处
│   └── Dockerfile
└── data/                    # 数据卷
    ├── wordpress/           # WordPress 文件（自动生成）
    └── mysql/               # MySQL 数据（自动生成）

📦 完整 docker-compose.yml

这是本项目的核心配置，定义了三个服务：wordpress、db（MySQL）和 phpmyadmin。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
services:
  wordpress:
    build:
      context: ./wordpress
      dockerfile: Dockerfile
    container_name: wordpress
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_NAME: wordpress
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
    volumes:
      - ./data/wordpress:/var/www/html
      - ./php.ini:/usr/local/etc/php/php.ini
    depends_on:
      - db

  db:
    image: mysql:8.0
    container_name: wordpress_db
    restart: always
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
      MYSQL_ROOT_PASSWORD: rootpassword
    volumes:
      - ./data/mysql:/var/lib/mysql

  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    container_name: phpmyadmin
    restart: always
    ports:
      - "8081:80"
    environment:
      PMA_HOST: db
      MYSQL_ROOT_PASSWORD: rootpassword
    depends_on:
      - db

🐘 Dockerfile（选择 PHP 版本）

你可以使用 WordPress 官方镜像的 PHP 变体，例如 PHP 8.3：

wordpress/Dockerfile

1
2
3
4
5
# 使用 PHP 8.3 的 WordPress 镜像
FROM wordpress:php8.3-apache

# 安装 mysqli 扩展（可按需添加更多扩展）
RUN docker-php-ext-install mysqli && docker-php-ext-enable mysqli

⚙️ 自定义 php.ini

如果你需要调整上传大小、内存限制等，可以创建一个 php.ini 文件：

php.ini

1
2
3
4
upload_max_filesize = 1024M
post_max_size = 1024M
memory_limit = 256M
max_execution_time = 300

该文件会在容器中挂载到 /usr/local/etc/php/php.ini，自动生效。

🚀 启动项目

确保你已经安装了 Docker 和 Docker Compose，然后在项目根目录运行：

1
docker compose up -d

启动成功后：

📌 常见问题 & 提示

  • 如何更换 PHP 版本？
    修改 Dockerfile 中的 FROM 行，例如换成 wordpress:php8.3-apache。如果确实需要旧版本，请先确认对应版本仍在维护。

  • WordPress 文件修改后不生效？
    确保 ./data/wordpress 目录存在并具有正确权限（尤其是在 Linux 下）。

  • php.ini 没生效？
    检查是否正确挂载，并重启容器：docker compose restart wordpress。

  • 生产环境能直接使用这份配置吗？
    不建议。示例中的用户名和密码只适合本地测试，生产环境应使用强密码、独立网络、备份策略和 HTTPS。

✅ 总结

通过上述配置，你可以快速搭建一个可自定义的 WordPress 环境，无需繁琐手动配置数据库或 PHP 设置。