使用 TiDB Cloud Starter 运行 WordPress

TiDB 是一个兼容 MySQL 的数据库，TiDB Cloud Starter 是一款全托管的 TiDB 云服务，WordPress 是一个免费的开源内容管理系统 (CMS)，可以让用户创建和管理网站。WordPress 使用 PHP 编写，并使用 MySQL 数据库。

在本教程中，你可以学习如何免费使用 TiDB Cloud Starter 运行 WordPress。

注意

除了 TiDB Cloud Starter，本教程同样适用于 TiDB Cloud Essential、TiDB Cloud Dedicated 以及 TiDB Self-Managed。但强烈推荐使用 TiDB Cloud Starter 来运行 WordPress，以获得更高的性价比。

前提条件

要完成本教程，你需要：

本节将演示如何使用 TiDB Cloud Starter 运行 WordPress。

在终端窗口中运行以下命令，克隆示例代码仓库：

git clone https://github.com/Icemap/wordpress-tidb-docker.git
cd wordpress-tidb-docker

示例仓库需要 Docker 和 Docker Compose 来启动 WordPress。如果你已经安装了它们，可以跳过此步骤。强烈建议你在 Linux 环境（如 Ubuntu）下运行 WordPress。运行以下命令安装 Docker 和 Docker Compose：
```
sudo sh install.sh
```
示例仓库包含了 TiDB Compatibility Plugin 作为子模块。运行以下命令以更新子模块：
```
git submodule update --init --recursive
```

配置 WordPress 数据库到 TiDB Cloud Starter 的连接。

进入 My TiDB 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。
点击右上角的 Connect。此时会弹出连接对话框。
确保连接对话框中的配置与你的操作环境一致。
- Connection Type 设置为 Public。
- Connect With 设置为 WordPress。
- Operating System 设置为 Debian/Ubuntu/Arch。
- Database 设置为你想要使用的数据库，例如 test。
点击 Generate Password 生成一个随机密码。

Tip

如果你之前已经创建过密码，可以继续使用原有密码，或者点击 Reset Password 生成一个新密码。
运行以下命令，将 .env.example 复制并重命名为 .env：
```
cp .env.example .env
```
将对应的连接字符串复制粘贴到 .env 文件中。示例结果如下：
```
TIDB_HOST='{HOST}'  # e.g. gateway01.ap-northeast-1.prod.aws.tidbcloud.com
TIDB_PORT='4000'
TIDB_USER='{USERNAME}'  # e.g. xxxxxx.root
TIDB_PASSWORD='{PASSWORD}'
TIDB_DB_NAME='test'
```
请确保将 {} 占位符替换为你在连接对话框中获得的连接参数。默认情况下，你的 TiDB Cloud Starter 自带一个 test 数据库。如果你已经在 TiDB Cloud Starter 实例中创建了其他数据库，可以将 test 替换为你的数据库名。
保存 .env 文件。

执行以下命令，将 WordPress 作为 Docker 容器运行：
```
docker compose up -d
```
通过访问 localhost（如果你在本地机器上启动容器）或 http://<your_instance_ip>（如果 WordPress 运行在远程机器上）来设置你的 WordPress 站点。