thinkphp模型指定独立数据库连接的核心做法是重写模型的 $connection 属性或在配置文件中定义多套连接参数。在分库场景下，需要在 database.php 中为不同的业务模块（如用户库、订单库）分别配置独立的连接信息，并在对应的 model 类中通过 setconnection() 方法或静态属性指向这些配置键名，从而实现读写分离或数据隔离。
如何在单个Model中切换非默认数据库？
当需要让某个特定模型使用非默认的数据库时，最直接的方式是在模型类内部覆盖 $connection 属性。该属性支持字符串形式的配置键名，也支持完整的数组配置。如果选择使用配置键名，必须确保 config/database.php 中已经存在对应的连接定义。这种方式适用于静态的数据库分配，即该模型始终只操作某一个特定的数据库实例。
namespace app\model;
use think\Model;
class User extends Model
{
// 指定使用 database.php 中定义的 'user_db' 连接
protected $connection = 'user_db';
}
上述代码展示了最基础的配置方式。假设 database.php 中有如下配置片段：
立即学习“PHP免费学习笔记（深入）”；
'user_db' => [
'type' => 'mysql',
'hostname' => '192.168.1.100',
'database' => 'user_center',
'username' => 'root',
'password' => 'secret',
],
此时，所有对 User 模型的查询都会自动路由到 user_center 数据库。如果需要在运行时动态切换，可以使用 setConnection() 方法。例如，在一个控制器中：
$user = new User();
$user->setConnection('backup_db');
$data = $user->find(1); // 此时查询 backup_db
这种动态切换通常用于临时性的数据迁移或特殊查询场景。需要注意的是，$connection 属性的优先级高于全局默认配置，但低于 setConnection() 的动态调用。在实际开发中，建议优先使用配置文件管理连接，避免硬编码连接参数。
分库架构下如何配置多个独立连接？
在微服务或大型单体应用中，分库是常见架构。ThinkPHP 通过 database.php 的 connections 数组来管理多个数据库连接。每个连接拥有唯一的键名，对应不同的主机、端口和数据库名。配置完成后，各个模型只需引用对应的键名即可实现物理隔离。这种配置方式不依赖任何中间件，完全由框架底层驱动处理连接池的建立与复用。
// config/database.php
return [
'default' => 'mysql',
'connections' => [
'mysql' => [
'type' => 'mysql',
'hostname' => '127.0.0.1',
'database' => 'main_app',
'username' => 'root',
'password' => 'pass',
],
'orders_db' => [
'type' => 'mysql',
'hostname' => '192.168.1.200',
'database' => 'order_system',
'username' => 'order_user',
'password' => 'order_pass',
],
'logs_db' => [
'type' => 'mysql',
'hostname' => '192.168.1.201',
'database' => 'log_system',
'username' => 'log_user',
'password' => 'log_pass',
],
],
];
在上述配置中，定义了三个独立的数据库连接：mysql 作为默认连接，orders_db 用于订单业务，logs_db 用于日志存储。对应的模型定义如下：
class Order extends Model {
protected $connection = 'orders_db';
}
class Log extends Model {
protected $connection = 'logs_db';
}
这样，Order 模型的所有操作都会指向 order_system 数据库，而 Log 模型则指向 log_system。这种配置方式清晰、解耦，且易于维护。如果需要增加新的分库，只需在 connections 数组中添加新的配置项，并在对应模型中引用即可。此外，还可以结合环境变量（如 .env 文件）来管理不同环境下的数据库地址，提高部署灵活性。
当模型未显式指定connection时会发生什么？
如果模型类中没有定义 $connection 属性，也没有调用 setConnection() 方法，ThinkPHP 会回退到使用全局默认数据库连接。这个默认连接由 config/database.php 中的 default 键值决定。通常情况下，default 指向 connections 数组中的第一个连接，或者明确指定的某个键名。这意味着，如果没有进行特殊配置，所有模型都将共享同一个数据库实例，这在分库场景下会导致数据混乱或查询失败。
class DefaultModel extends Model
{
// 未定义 $connection
}
// 假设 database.php 中 default 为 'mysql'
$model = new DefaultModel();
$result = $model->table('users')->select();
// 此查询将执行在 'mysql' 配置的数据库中
这种行为确保了系统的默认兼容性，但也要求开发者在分库设计中必须显式地为每个模型指定连接。否则，新添加的模型可能会意外地写入主库，造成数据不一致。建议在项目初始化阶段，就建立严格的模型命名规范或基类继承机制，强制所有模型继承自一个带有默认连接检查的基类，从而避免此类错误。同时，可以通过单元测试验证模型连接的准确性，确保每个模型都指向预期的数据库实例。
