ThinkPHP搭建项目后如何配置数据库 操作步骤详解

ThinkPHP 项目搭建完成后，数据库配置是启动数据操作的第一步，也是绕不开的一步。核心其实很简单：把连接参数填对，让框架知道该连哪个库、用什么账号、怎么连。不同版本（比如 TP5.x 和 TP6.x）路径和写法略有差异，但逻辑完全一致——无非就是告诉框架“数据库类型、地址、名称、账号密码”这几个关键信息。

确认数据库服务已就绪

在动手配置之前，先确认三件事是不是已经到位：

• MySQL（或其他数据库）服务正在运行。不管是通过 phpStudy、XAMPP 还是 Docker 启动的，只要服务没起来，配置啥都白搭。
• 目标数据库已经创建好了（比如 thinkphp_db）。字符集建议选 utf8mb4，排序规则用 utf8mb4_unicode_ci，这样存储 emoji 和特殊字符都不会出问题。
• 有可用的数据库账号和密码。推荐使用非 root 账号，权限只要对目标库具备 SELECT/INSERT/UPDATE/DELETE 就够了，避免权限过大带来的安全风险。

编辑 database.php 配置文件

这是最常用也最推荐的方式，无论是单库还是主从结构都能搞定。文件路径根据版本略有不同：

• TP6.x 路径：config/database.php（项目根目录下的 config 文件夹）
• TP5.x 路径：application/database.php

打开文件后，会看到一个返回关联数组的配置项。需要填写的字段包括：

type → 数据库类型，比如 'mysql'（也支持 pgsql、sqlite、sqlsrv、oracle 等）；
hostname → 数据库服务器地址，本地开发通常用 '127.0.0.1' 或 'localhost'；
database → 数据库名，例如 'thinkphp_db'；
username → 登录用户名，比如 'root'；
password → 对应的密码；
hostport → 端口号，MySQL 默认是 '3306'；
charset → 字符编码，强烈建议设为 'utf8mb4'，避免 emoji 存储异常；
prefix → 表前缀，如 'tp_'，模型中未指定表名时会自动添加前缀；
auto_timestamp → 可设为 true，启用后新增/更新时自动写入 create_time 和 update_time 字段。

这些字段缺一不可，尤其是 hostname、database、username、password 这几个，一旦写错，连库都连不上。

验证配置是否生效

配置保存后，别急着往下写业务代码，先跑个简单查询验证一下连接是否成功：

• 在控制器中引入 Db 类：use think\facade\Db;
• 执行一条基础查询：Db::query('SELECT VERSION()'); 或 Db::table('user')->find();
• 如果返回结果没有报错（比如看到了 MySQL 版本号或用户数据），说明配置已经生效，连接成功。
• 如果报错提示“Connection refused”或“Access denied”，回过头检查 hostname、端口、账号密码、数据库是否存在、防火墙设置等。最常见的问题就是账号密码输错，或者数据库名写错了。

进阶：多库配置与动态切换

当项目需要同时访问多个数据库（比如用户库和日志库分开），可以在 database.php 中定义 connections 数组：

• 每个子数组代表一个独立的连接，例如 'log_db' 和 'user_db'。
• 使用时通过 Db::connect('log_db') 获取对应实例，再调用 ->name('log')->select() 即可。
• 也可以结合 .env 文件管理不同环境的参数，比如在 .env 中写 DATABASE2_HOSTNAME=192.168.1.100，然后在配置中用 env('database2.hostname') 读取，这样多环境切换起来非常方便。