ThinkPHP怎样配置数据库主从分离_数据库主从分离配置【进阶】-ThinkPHP-PHP中文网

thinkphp主从分离需启用deploy和rw_separate开关，从库配置为二维数组、主库为一维数组；特殊场景可显式指定读连接或强制主库；事务与锁查询自动走主库；tp5升级tp6须重构配置结构。

thinkphp怎样配置数据库主从分离_数据库主从分离配置【进阶】

如果您在ThinkPHP项目中需要将数据库读操作分发至从库、写操作定向主库，但发现配置后所有查询仍走默认连接，则可能是由于读写分离开关未启用或从库配置结构不合法。以下是实现数据库主从分离的多种配置方法：

一、启用部署模式与读写分离开关（TP6标准方式）

该方法为ThinkPHP 6.x官方推荐配置路径，依赖deploy总开关与rw_separate路由策略协同生效，缺一不可。仅配置read和write数组而未启用deploy将导致整个读写分离逻辑完全不触发。

1、打开config/database.php文件，确保default键值设为自定义连接名（如'mysql'），而非直接嵌套数据库参数。

2、在connections配置项下新增名为'mysql'的完整连接定义，其中必须包含：'deploy' => 1、'rw_separate' => true、'read' => [['host' => '192.168.1.10', 'username' => 'ro_user']]、'write' => ['host' => '192.168.1.5', 'username' => 'rw_user']。

3、确认'read'值为二维数组（即使单从库也需包裹成[...]），若写成一维数组或对象将静默失败。

4、'write'必须为一维关联数组，严禁写成数组套数组，否则启动时报错Invalid write database config。

二、显式指定读连接并强制绑定（TP6兼容性方案）

当业务存在部分查询需稳定落在特定从库（如报表库物理隔离）、或需绕过框架自动路由逻辑时，可采用手动连接+显式调用方式。此法不依赖rw_separate，适用于调试或特殊路由场景。

1、在connections中独立定义一个只读连接，例如键名为'mysql_slave'，其配置不含deploy或rw_separate，仅含标准MySQL参数。

2、在控制器或模型中使用Db::connect('mysql_slave')获取该连接实例，后续所有操作均固定指向该从库。

3、对普通查询构造器链式调用，添加->useReadConnection()方法，例如：Db::table('user')->useReadConnection()->select()。

4、注意：模型类如UserModel::select()默认仍走default连接，不会继承Db::connect()上下文，必须显式调用useReadConnection()才生效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

三、事务与锁语句下的主库强制路由（一致性保障方案）

为避免主从延迟引发数据不一致，ThinkPHP在事务上下文或带锁查询中自动降级至主库执行。该机制不可绕过，是框架内置安全策略，开发者需明确识别并适配。

1、任何位于Db::transaction()回调内的查询（包括select()），无论是否加锁，全部强制路由至主库。

2、在SELECT语句中使用->lock(true)或原生SQL含FOR UPDATE、LOCK IN SHARE MODE时，框架自动识别为强一致性读，跳过从库轮询，直连主库。

3、若需在事务外强制某次查询走主库，使用整链Db::master()->table('log')->where('id', 1)->find()，单独调用Db::master()后未链式调用将无效。

4、getLastSql()仅返回SQL字符串，不反映实际执行库；验证是否走从库应通过SHOW PROCESSLIST查看客户端IP连接目标，或在think\db\Connection::connect()中注入日志打印$config['hostname']与$isRead标志。