环境搭建

这一课你将能做到

1. 用 Docker 独立搭起一套 WP 6.x + PHP 8.2 + MySQL 8 的本地环境（并知道 Local 方案的取舍）
2. 完成五分钟安装，读懂 wp-config.php 里每一行关键配置
3. 用 WP-CLI 完成首次「体检」：查版本、列插件、看用户

为什么要学

所有后续课程都跑在这一课的环境上。更重要的是：会装只是起点，读懂 wp-config.php 和目录结构，你才能排查白屏、配置调试、控制数据库——生产事故的第一现场全在这里。

人话：这课相当于拿到新房钥匙后先摸清水电总闸在哪。总闸都找不到，后面装修全靠猜。

先建立图像

你的请求 http://localhost:8080
   ↓
容器 wordpress (PHP 8.2 + Apache + WP 6.x)   ← 读 /var/www/html
   ↓ 连接 db:3306（注意不是 localhost!）
容器 db (MySQL 8)  ← 数据落在命名卷 wpdb_data
   ↓
浏览器看到安装向导 / 首页

关键认知：容器之间用「服务名」通信。WP 容器里连数据库要写 db，写 localhost 会连到 WP 容器自己——这是初学者报「数据库连接错误」的头号原因。

跟着做

步骤 1：Docker Compose 一键起环境

新建目录 wp-lab，在其中创建 docker-compose.yml：

services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppass
    volumes:
      - wpdb_data:/var/lib/mysql
  wordpress:
    image: wordpress:6-php8.2-apache
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db        # 服务名，不是 localhost
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wp_data:/var/www/html     # 之后主题插件在这里
volumes:
  wpdb_data:
  wp_data:

执行：

docker compose up -d

浏览器打开 http://localhost:8080。

步骤 2：完成五分钟安装

安装向导选「简体中文」→ 填站点标题 → 设管理员账号密码（本地随便，生产必须强密码）→ 安装。完成后登录 /wp-admin/。

不想用 Docker：装 Local（原 LocalWP）图形化一键建站，自带 PHP 版本切换与邮件捕获，适合怕命令行的初学者。本课程代码两种环境通用。

步骤 3：读懂 wp-config.php

进入 WP 容器查看配置：

docker compose exec wordpress bash
cat /var/www/html/wp-config.php

重点行解读：

define( 'DB_NAME', 'wordpress' );      // 库名
define( 'DB_USER', 'wpuser' );         // 数据库用户
define( 'DB_PASSWORD', 'wppass' );     // 密码
define( 'DB_HOST', 'db' );             // 主机：容器里是服务名
$table_prefix = 'wp_';                 // 表前缀，多站共用一库时用于隔离
define( 'WP_DEBUG', false );           // 调试总开关，本地开发改 true