ThinkPHP中废弃的数据库连接配置如何升级_利用多数据库配置技巧-ThinkPHP-PHP中文网

thinkphp 5.1+ 中 database.php 的 'type' 必须使用全路径类名加 ::class（如 \think\db\connector\mysql::class），不再支持 'mysql' 字符串；多库配置中 default 值须严格匹配 connections 键名，db::connect() 仅接受键名而非配置数组，tp6.0+ 配置由 think-orm 独立包管理，需清理缓存并确保无框架版本冲突。

thinkphp中废弃的数据库连接配置如何升级_利用多数据库配置技巧

ThinkPHP 5.1+ 中 `database.php` 的 `'type'` 不再支持 `'mysql'` 字符串写法

旧版 TP5.0 及更早允许在 database.php 中直接写 'type' => 'mysql'，但 5.1+ 已废弃该写法，会报错 Class 'think\db\connector\Mysql' not found 或连接失败。本质是底层改用完整类名映射，字符串类型被移除。

必须改为类名全路径：

'type' => \think\db\connector\Mysql::class,

其他数据库同理：\think\db\connector\Pgsql::class、\think\db\connector\Sqlite::class。

不写 ::class 而直接写字符串（如 'type' => 'mysql'）会触发自动加载失败
若使用 IDE 自动补全，注意别误补成 think\db\connector\Mysql（缺 ::class），PHP 会当常量解析并报错 Use of undefined constant
TP6.0+ 进一步收紧，连 think\db\connector\Mysql 这种字符串写法也彻底不认了，只接受 ::class 形式

多数据库配置里，`default` 和 `connections` 的键名必须严格匹配

新版多库配置要求 default 值必须是 connections 数组里的某个键名，且大小写敏感。比如设了 'default' => 'master'，但 connections 里写的是 'Master' => [...]，就会 fallback 到默认 sqlite 配置，查不到表还报 Base table or view not found。

典型正确结构：

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

'default' => 'master',
'connections' => [
    'master' => [
        'type' => \think\db\connector\Mysql::class,
        'hostname' => '127.0.0.1',
        // ...
    ],
    'slave' => [/* ... */],
],

键名不要带空格、下划线或中横线（如 'read-slave' 在某些版本会因解析异常导致连接失败）
如果用了环境变量动态配置（如 env('DB_CONNECTION', 'master')），确保环境变量值和 connections 键名完全一致
TP6.3+ 对键名校验更严格，非法键名可能直接抛出 InvalidArgumentException

切换数据库时，`Db::connect()` 的参数不能传配置数组，只能传键名

很多人习惯把整个数据库配置数组传给 Db::connect()，比如 Db::connect(['type' => ..., 'hostname' => ...])，这在新版里已失效——它只会尝试从 connections 中查找该数组的 'name' 键，而不是合并配置。结果是连接默认库，或者报 Connection not found。

正确做法是：先在 connections 中定义好命名连接，再用键名调用：

// ✅ 正确
Db::connect('slave')->table('user')->select();
<p>// ❌ 错误（不会生效）
Db::connect(['hostname' => '192.168.1.100'])->table('user')->select();</p>

临时连接非配置库，应改用 Db::connect()->setConfig([...])（TP6.2+ 支持），但仅限调试，不建议线上用
若需运行时动态选库（如按用户 ID 分库），务必提前在 connections 中预定义所有可能的键名，避免运行时拼接键名出错
Db::connect('xxx') 返回的实例不共享事务上下文，跨连接的 startTrans() / commit() 无效

TP6.0 升级后，`think-orm` 独立包导致配置文件位置变化

TP6.0 把数据库组件抽成独立包 topthink/think-orm，配置不再读取 config/database.php，而是走 config/database.php（没错，路径没变），但加载时机和合并逻辑变了：如果项目里还保留旧版 thinkphp/library/think/db/ 相关手动引入，或混用 think\Db 和 think\facade\Db，会出现配置不生效、始终连 sqlite 的现象。