ThinkPHP如何配置多个数据库连接_环境配置文件与动态切换-ThinkPHP-PHP中文网

ThinkPHP多数据库需在config/database.php中定义多个唯一键名连接（如'mysql_read'），每个必须显式声明'type'且键名不含点号或大写字母；Db::connect()参数为配置键名而非数据库名，传错抛异常；模型$connection仅初始化时生效，跨库关联须手动分查；环境变量覆盖用DATABASE_X_Y_Z二维语法。

thinkphp如何配置多个数据库连接_环境配置文件与动态切换

数据库配置文件里怎么写多个连接

ThinkPHP 的多数据库支持靠的是在 config/database.php 里定义多个键名，而不是只留一个 default。每个连接必须有唯一键名（比如 'mysql_read'、'pgsql_log'），且结构和默认连接一致。

常见错误是复制粘贴后忘了改 hostname 或 database，结果两个连接连的其实是同一个库；或者漏掉 'type' 导致框架用默认 mysql 去解析 PostgreSQL 配置，报错 Class 'PDO' not found。

所有连接都必须显式声明 'type'（如 'mysql'、'pgsql'、'sqlsrv'）
连接名不能含点号或大写字母，否则 Db::connect('log.db') 会失败
如果某个连接只读不用写，建议把 'write_master' 设为 false，避免误触发主库写操作

'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',
],

Db::connect() 动态切换连接时传什么参数

Db::connect() 的参数不是数据库名，而是配置文件里定义的连接键名（比如 'mysql_read'），它会直接加载对应配置并返回一个新的 Query 对象。传错名会抛出异常 Connection not found: xxx。

注意：这个调用不改变全局默认连接，每次都要显式调用；也不支持运行时修改已创建连接的 host 或 port —— 那些属于配置项，只能在 config 文件或通过环境变量预设。

传字符串：Db::connect('mysql_read') → 返回只读连接实例
传数组：Db::connect(['type'=>'sqlite','database'=>'/tmp/test.db']) → 临时连接，不走配置文件
不要传模型名或表名，Db::connect('User') 是错的

模型类里指定连接和自动切换的边界在哪

模型类用 protected $connection = 'mysql_read'; 可绑定固定连接，但这个值只在模型首次初始化时读取一次；如果运行中切换了数据库配置（比如 reload config），模型不会自动感知。更关键的是：关联查询（with()）默认仍走当前模型的 $connection，不会智能路由到被关联模型的连接上。

容易踩的坑是以为设置了 $connection 就能跨库 join —— 实际上 MySQL 不允许直接 join 不同实例的表，TP 也不会帮你做数据合并，这时候得手动查两次再 PHP 合并。

跨库关联必须拆成多次查询，不能依赖 join()
scope 或 globalScope 中若用了 Db::name()，它仍走默认连接，不受模型 $connection 影响
事务只对单个连接有效，Db::startTrans() 无法跨连接保证一致性

env 环境变量覆盖多连接配置的写法

线上不同环境要区分读写库地址？别硬编码进 database.php。ThinkPHP 支持用 .env 覆盖配置，但多连接场景下必须用“二维键名”语法，例如：

DATABASE_MYSQL_WRITE_HOSTNAME=10.0.1.5
DATABASE_MYSQL_READ_HOSTNAME=10.0.1.6
DATABASE_MYSQL_WRITE_DATABASE=prod_main
DATABASE_MYSQL_READ_DATABASE=prod_slave

框架会自动把 DATABASE_X_Y_Z 映射成 database.x.y.z，所以最终生效的是 database.mysql_write.hostname。漏掉中间层级（比如写成 DATABASE_MYSQL_WRITEHOST）会导致覆盖失败，还是读 config 文件里的旧值。