CodeIgniter4数据库读写分离与微服务集成-php教程-PHP中文网

codeigniter 4 不支持开箱即用的读写分离和微服务集成，需手动实现数据库路由与跨服务通信；其设计哲学是“不替你做决定”，所有连接控制、切换时机和错误边界均由开发者明确管理。

codeigniter4数据库读写分离与微服务集成

CodeIgniter 4 不支持开箱即用的读写分离，也不内置微服务集成能力——所有数据库路由和跨服务通信必须手动实现。它的设计哲学是“不替你做决定”，所以你需要明确控制连接、切换时机和错误边界。

为什么不能直接用 `database.php` 配置读写分离

CI4 完全忽略 app/Config/Database.php 中的任何数据库配置，只从 .env 文件加载单一默认连接。这意味着：
• 即使你在 Database.php 里定义了 $db['slave']，它也不会被加载；
• \Config\Database::connect() 永远只返回 default 组的实例；
• 所有模型、查询构造器、事务操作都绑定在这一连接上，无法自动分流。

手动实现读写分离的三个关键点

你要自己接管连接选择逻辑，而不是依赖框架自动识别 SELECT 或 INSERT：

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

定义多个环境变量组：在 .env 中添加 database.read.hostname、database.write.hostname 等字段，不要复用 default 命名；

封装连接工厂：在 app/Config/Services.php 中新增闭包绑定，例如：

$container->set('db_read', function () {
    return \CodeIgniter\Database\MySQLi\Connection::forge([
        'hostname' => env('database.read.hostname', 'localhost'),
        'username' => env('database.read.username', 'root'),
        'password' => env('database.read.password', ''),
        'database' => env('database.read.database', 'myapp_ro'),
        'DBDriver' => 'MySQLi',
    ]);
});

$container->set('db_write', function () {
    return \CodeIgniter\Database\MySQLi\Connection::forge([
        'hostname' => env('database.write.hostname', 'localhost'),
        'username' => env('database.write.username', 'root'),
        'password' => env('database.write.password', ''),
        'database' => env('database.write.database', 'myapp_rw'),
        'DBDriver' => 'MySQLi',
    ]);
});

在模型中显式调用：$this->db_read->table('users')->get() 读，$this->db_write->table('logs')->insert($data) 写；不要尝试覆盖 $this->db 属性，否则会破坏 CI4 的 Query Builder 缓存和事务上下文。

微服务集成时最容易漏掉的三件事

当你的 CI4 应用需要调用用户中心、订单服务等外部微服务时，数据库层面的隔离比连接管理更关键：

绝不共享数据库凭证：每个微服务应拥有最小权限账号，比如订单服务只能查 orders 表，不能碰 users；
禁用跨库 JOIN：CI4 的 Query Builder 不支持跨远程服务的表关联，硬写 JOIN users ON orders.user_id = users.id 会直接失败；替代方案是先查订单 ID 列表，再批量请求用户服务接口；
超时与重试必须设限：用 cURL 或 Guzzle 调用微服务时，connect_timeout=2、timeout=5 是底线；否则一个慢响应会拖垮整个 Web 请求生命周期。