PHP的mysqli和PDO不支持自动读写分离，需应用层手动管理主从连接：写操作走主库，读操作走从库，并注意事务、持久连接及主从延迟问题。
PHP 连接 MySQL 主从集群时，mysqli 和 PDO 本身不支持自动读写分离
PHP 的原生扩展（如 mysqli、PDO_MYSQL）只提供单点连接能力，不会识别「主库写、从库读」的语义。所谓「连主从」，实际是应用层自己决定往哪个地址发请求——不是靠 PHP 驱动自动切换，而是你写代码时明确指定连接哪台机器。
常见错误是以为只要把主从 IP 填进 host 就能自动分发，结果所有请求都打到同一个节点，主库压力爆表，从库闲置。
- 必须手动维护至少两个连接：一个指向主库（
$master），一个或多个指向从库（$slaves） - 写操作（
INSERT/UPDATE/DELETE）只走$master - 读操作（
SELECT）可走$slaves，但需你自己做负载策略（轮询、随机、权重） - 事务中所有 SQL 必须走主库，否则会丢数据或报错
Can't execute statement in a READ ONLY transaction
用 mysqli 手动管理主从连接的最小可行写法
不要封装过早，先跑通逻辑。以下是最简结构，直接贴进脚本能验证：
// 主库连接（写）
$master = new mysqli('192.168.1.10', 'user', 'pass', 'db', 3306);
if ($master->connect_error) die('Master connect failed: ' . $master->connect_error);
// 从库连接（读），这里只用一台，可扩展为数组
$slave = new mysqli('192.168.1.11', 'user', 'pass', 'db', 3306);
if ($slave->connect_error) die('Slave connect failed: ' . $slave->connect_error);
// 写操作
$master->query("INSERT INTO log (msg) VALUES ('test')");
// 读操作
$result = $slave->query("SELECT COUNT(*) FROM log");
list($cnt) = $result->fetch_row();
echo "Total: $cnt";
注意：mysqli 实例之间完全独立，不能混用 query() 方法和连接对象。用错对象会导致查询发到错误节点，且无任何警告。
立即学习“PHP免费学习笔记（深入）”；
PDO 做主从路由要避开 PDO::ATTR_PERSISTENT 和事务陷阱
PDO 更适合封装，但两个坑必须提前踩过：
- 持久连接（
PDO::ATTR_PERSISTENT => true）在主从场景下极易复用错连接。比如上次请求用的是从库连接，下次却拿它去执行INSERT，MySQL 会直接拒绝 - 显式开启事务（
$pdo->beginTransaction()）后，后续所有语句都会绑定到当前连接。如果事务开始于从库连接，INSERT会失败并抛出SQLSTATE[HY000]: General error: 1792 Cannot execute statement in a READ ONLY transaction - 建议对写操作单独建
$pdo_master实例，读操作用$pdo_slave，且都关闭持久化
连接参数示例：
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_PERSISTENT => false, // 关键
];
$pdo_master = new PDO('mysql:host=192.168.1.10;dbname=db', 'user', 'pass', $options);
$pdo_slave = new PDO('mysql:host=192.168.1.11;dbname=db', 'user', 'pass', $options);
主从延迟导致读不到刚写入的数据，PHP 层怎么兜底
MySQL 主从复制有毫秒到秒级延迟，PHP 发完 INSERT 立刻去从库查，大概率查不到。这不是代码 bug，是架构约束。应对方式只有三种，没有银弹：
- 强一致性读：所有涉及「刚写就查」的读请求，强制走主库（例如订单创建后立即查订单详情）
- 带版本/时间戳的重试：写完后查从库，若没查到，等待 50ms 后重试，最多 3 次；超时则降级为主库查
- 业务妥协：前端提示「数据同步可能需要几秒」，后端不处理，靠用户刷新
最容易被忽略的是：**延迟不是网络问题，是 MySQL 复制机制决定的**。加索引、调大 innodb_flush_log_at_trx_commit 只能缓解，不能消除。你的 PHP 代码得默认接受这个事实，而不是试图“优化掉”它。
