Yii2.0.50 实现读写分离本质是通过 db 组件的 slaveConfig 与 slaves 配置自动路由:写操作(INSERT/UPDATE/DELETE)走主库,读操作(SELECT)自动分发至从库,无需修改 Model 或 Query 语句,仅需正确配置主从环境及数据库组件参数。

在 Yii2.0.50 中实现读写分离,本质是让写操作(INSERT/UPDATE/DELETE)走主库,读操作(SELECT)自动路由到从库,前提是已搭建好 MySQL 主从复制环境且网络互通。配置本身不涉及代码逻辑改动,全靠 【db 组件的 slaveConfig + slaves 配置】 触发框架底层自动分发,无需修改 Model 或 Query 语句。
确认主从数据库已就绪
检查主库(master)和至少一个从库(slave)是否已正确配置复制并处于运行状态:执行 SHOW SLAVE STATUS\G,确认 Slave_IO_Running 和 Slave_SQL_Running 均为 Yes;主库能正常写入,从库能实时同步数据。这一步不可跳过,否则 Yii2 的读写分离会因从库无响应而降级回主库读取,失去分流意义。
记录主库 DSN(如 mysql:host=192.168.1.10;dbname=myapp)和从库 DSN(如 mysql:host=192.168.1.11;dbname=myapp),确保端口、用户名、密码与实际一致。
修改数据库配置文件
打开项目配置文件 common/config/main-local.php(或 config/db.php,依项目结构而定),定位到 'db' 组件定义处。
将原单库配置替换为以下结构:
① 保留主库基础连接参数(class、dsn、username、password、charset);
② 新增 'slaveConfig' 数组,用于统一指定所有从库共用的连接属性,例如超时时间、字符集;
③ 新增 'slaves' 数组,每一项是一个从库的完整 DSN 配置(仅需 dsn 字段,其余继承 slaveConfig);
④ 删除原配置中可能存在的 'tablePrefix' 等非连接相关字段,避免干扰连接初始化。
完整示例:
'db' => [ 'class' => 'yii\db\Connection', 'dsn' => 'mysql:host=192.168.1.10;dbname=myapp', 'username' => 'master_user', 'password' => 'master_pass', 'charset' => 'utf8mb4', 'slaveConfig' => [ 'username' => 'slave_user', 'password' => 'slave_pass', 'attributes' => [PDO::ATTR_TIMEOUT => 5], 'charset' => 'utf8mb4', ], 'slaves' => [ ['dsn' => 'mysql:host=192.168.1.11;dbname=myapp'], ['dsn' => 'mysql:host=192.168.1.12;dbname=myapp'], ],],
验证读写分离是否生效
在任意控制器中插入测试代码:
$rows = \Yii::$app->db->createCommand("SELECT id, name FROM user LIMIT 1")->queryAll();
该语句执行后,查看 MySQL 从库的慢查询日志或通用日志(启用 general_log=ON),确认该 SELECT 确实发生在从库 IP 上;
\Yii::$app->db->createCommand("UPDATE user SET status=1 WHERE id=1")->execute();
再查主库 binlog 或执行 SHOW PROCESSLIST,确认 UPDATE 出现在主库连接中。
【注意:只有 queryAll()、queryOne()、queryColumn() 等以 query 开头的方法才触发从库读取;execute()、insert()、update()、delete() 均强制走主库】











