ThinkPHP数据库配置全攻略

ThinkPHP多数据库配置看似简单，实则暗藏诸多易踩坑的硬性约束：键名必须严格使用小写加下划线（如'mysql_read'）、每个连接必须显式声明'type'、Db::connect()参数只能是配置键名而非数据库名或模型名——三者稍有错位便立即抛异常；文章直击90%连接失败的根源，详解键名规范、type强制声明、动态连接调用、模型$connection的静态局限、跨库关联查询的不可自动路由、SQL Server特殊连接逻辑及环境变量覆盖规则，帮你避开复制粘贴配置后的连库静默失败、读写分离失效、租户路由失控等真实生产陷阱。

ThinkPHP 多数据库连接不是靠“加几个配置项”就能跑通的，关键在键名、type、调用方式三者必须严格对齐；传错 Db::connect() 的参数或漏写 type，90% 的报错都出在这儿。

database.php 里怎么定义多个连接

每个连接必须是独立键名，且只允许小写字母 + 下划线，不能含点号或大写 —— Db::connect('log.db') 会直接抛异常，正确写法是 'log_db'。

所有连接都必须显式声明 type，哪怕都是 MySQL：不写 'type' => 'mysql'，框架就默认用 MySQL 驱动去解析 PostgreSQL 配置，结果报 Class 'PDO' not found。

常见错误包括：

• 复制 mysql_write 配置后忘了改 hostname 或 database，两个连接实际连向同一台机器
• 把 mysql_read 的 'write_master' => false 漏掉，导致读操作意外触发主库写入
• 用 DB_TYPE 这类 ThinkPHP 3 的旧键名，新版已不识别，连接静默失败

示例片段：

'mysql_write' => [
    'type'     => 'mysql',
    'hostname' => '192.168.1.10',
    'database' => 'app_main',
    'username' => 'root',
    'password' => 'xxx',
],
'mysql_read' => [
    'type'        => 'mysql',
    'hostname'    => '192.168.1.11',
    'database'    => 'app_main',
    'username'    => 'ro_user',
    'password'    => 'yyy',
    'write_master'=> false,
],

Db::connect() 传什么参数才有效

Db::connect() 的参数不是数据库名，也不是模型名，而是 database.php 里定义的连接键名（如 'mysql_read'）；传错就抛 Connection not found: xxx。

它返回的是一个全新 Query 实例，不改变全局默认连接 —— 每次要用，都得显式调用一次。

支持两种传参方式：

• 传字符串：Db::connect('mysql_read') → 加载对应配置，走连接池（如果启用）
• 传数组：Db::connect(['type'=>'sqlite','database'=>'/tmp/test.db']) → 临时连接，绕过配置文件，适合调试或单次轻量操作

绝对不要传：Db::connect('User')、Db::connect('app_main')、Db::connect('default')（除非你真在配置里写了叫 default 的键）。

模型类里 $connection 怎么设才生效

protected $connection = 'mysql_read'; 只在模型类第一次实例化时读取一次，之后改配置、重载 config 文件，这个值也不会刷新。

更关键的是：关联查询（比如 User::with('profile')->select()）不会自动跨库路由 —— 即使 User 绑了 mysql_write，Profile 绑了 mysql_read，with() 仍全部走 User 的连接，不会自动切到 Profile 的库上。

想真正跨库查，只能手动分查：

• 先用 Db::connect('mysql_write')->name('user')->select()
• 再用 Db::connect('mysql_read')->name('profile')->where('id','in',$ids)->select()
• 最后在 PHP 层做数据合并

SQL Server 连接特别注意 hostname 和 hostport

SQL Server 在 ThinkPHP 中容易连不上，不是密码错，而是地址和端口填法反直觉：

• 填 'hostname' => '127.0.0.1' 常报 命名管道提供程序: 无法打开与 SQL Server 的连接；换成 'hostname' => 'localhost' 才行
• 填 'hostport' => '1433' 可能报 TCP 提供程序: 由于目标计算机积极拒绝,无法连接；留空或设为 '' 反而能连通
• type 必须是 'sqlsrv'，不能写成 'mssql' 或 'pdo_sqlsrv'

环境变量覆盖多库配置时，要用二维语法：DATABASE_MYSQL_READ_HOSTNAME=192.168.1.11，而不是扁平的 MYSQL_READ_HOSTNAME。

最常被忽略的一点：连接名一旦写进模型的 $connection，就锁死了；运行中没法热切换。如果业务需要按请求动态路由到不同库（比如租户隔离），别依赖模型属性，老实用 Db::connect($key) 显式控制。

本篇关于《ThinkPHP数据库配置全攻略》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！