ThinkPHP8多数据源配置教程：新手如何快速上手-ThinkPHP-PHP中文网

thinkphp 8 不支持单模型动态切换多数据库连接，必须为每个数据源定义独立配置并显式调用 db::connect('name') 或设置模型 $connection 属性；跨库关联需分步查询或原生 sql；事务仅限单连接内生效。

thinkphp8多数据源配置教程：新手如何快速上手

ThinkPHP 8 不支持在单个模型里动态切换多个数据库连接——必须为每个数据源定义独立的连接配置，并通过 Db::connect() 或指定模型的 connection 属性来显式调用。

多数据源不是“自动识别”，而是靠显式连接名调用

新手常误以为只要在 config/database.php 里写多个配置，模型就能“自动选库”。实际并非如此：TP8 的 Db 类和模型默认只使用 'default' 连接；其他连接必须手动指定名称（如 'slave'、'log_db'）并显式传入。

Db::connect('slave') 返回一个独立的 Db 实例，后续所有链式操作（name()、where()、select()）都走该连接
模型中可通过 protected $connection = 'log_db'; 绑定专属连接，但该模型所有操作将固定走此库，无法运行时切换
不推荐在模型里用 Db::connect() 混用——会破坏模型的数据一致性语义，容易引发事务、事件、缓存失效等问题

database.php 中配置多个连接，注意 key 命名与结构一致性

每个连接配置块必须是完整、自包含的数组，不能复用上级字段。常见错误是把 'host' 写在顶层，导致非 default 连接读不到主机地址。

正确写法：每个连接名（如 'slave'）下直接嵌套全部数据库参数：'type'、'hostname'、'database'、'username' 等
连接名必须是合法 PHP 标识符（不能含短横线、空格），且不能与保留字冲突（如 default、master 是常用名，但 class 或 return 会报错）
密码等敏感字段建议从 .env 加载：'password' => env('DB_SLAVE_PASSWORD', '')，避免硬编码泄露

示例片段（config/database.php）：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

return [
    'default' => 'mysql',
    'connections' => [
        'mysql' => [
            'type'        => 'mysql',
            'hostname'    => env('DB_HOST', '127.0.0.1'),
            'database'    => env('DB_NAME', 'app_main'),
            'username'    => env('DB_USER', 'root'),
            'password'    => env('DB_PASS', ''),
            // ... 其他参数
        ],
        'log_db' => [
            'type'        => 'mysql',
            'hostname'    => env('DB_LOG_HOST', '127.0.0.1'),
            'database'    => env('DB_LOG_NAME', 'app_log'),
            'username'    => env('DB_LOG_USER', 'logger'),
            'password'    => env('DB_LOG_PASS', ''),
            // 必须重复声明全部必要字段，不可省略
        ],
    ],
];

跨库关联查询不能用 think\Model 的原生关联，得手写 join 或分步查

TP8 的 hasOne、hasMany 等关联方法基于单一模型连接，无法跨数据源执行 JOIN。例如用户表在 mysql，日志表在 log_db，直接定义 UserModel::with('logs') 会报错或查空。

方案一（推荐）：分步查询 —— 先查主表 ID 列表，再用 Db::connect('log_db')->whereIn('user_id', $ids)->select() 手动聚合
方案二：用原生 SQL + Db::query()，但需自行处理参数绑定、防注入和结果映射
方案三：将日志表迁入主库（加前缀或 schema 区分），回归标准关联，适合中小项目

若坚持用模型，可为日志单独建 LogModel 并设 protected $connection = 'log_db';，但 with() 仍不支持跨连接预加载。