CodeIgniter4多数据库连接与读写分离全解析

夏杰大大_5300

夏杰大大_5300

2026-08-08

182人浏览

原创

codeigniter 4 不支持开箱即用的多数据库连接或读写分离,因 database.php 被忽略、.env 仅解析 default 配置、database::connect() 硬编码只读 default 组且不接受参数,无法动态加载 slave 数据库;必须通过原生 mysqli/pdo 连接并手动桥接 query builder,或借助 proxysql 等代理层实现读写分离。

codeigniter4多数据库连接与读写分离全解析

CodeIgniter 4 不支持开箱即用的多数据库连接或读写分离——Database.php 被完全忽略,.env 只允许定义一套 default 配置,框架底层也未提供 $this->load->database('slave') 这类 CI3 风格的动态加载机制。

CI4 中为什么不能像 CI3 那样直接 load 多个数据库

CI4 的数据库初始化在 \Config\Database::connect() 中硬编码为只读取 default 组;Database.php 文件仅用于生成默认配置骨架,实际连接参数全部来自 .env,且不解析 database.slave.* 这类自定义键名。试图在 .env 里加 database.slave.hostname 不会生效,框架会静默跳过。

常见错误现象:Call to a member function query() on nullUndefined property: App\Controllers\MyController::$slave_db —— 因为 $this->slave_db 根本没被创建。

  • CI4 的 Database 类是单例 + 静态工厂模式,不支持运行时切换或并行实例化多个独立连接对象
  • \Config\Database::connect('slave') 会报错:该方法不接受参数,签名固定为 connect(): BaseConnection
  • 即使手动 new mysqli() 或 PDO 实例,也无法复用 CI4 的 Query Builder、事务管理、防注入等能力

可行方案:用原生连接 + 手动桥接 Query Builder

若必须在 CI4 中操作第二个数据库(如日志库、报表库),唯一可靠方式是绕过框架封装,用原生连接,并把查询结果手动喂给 Query Builder 的 set() / insertBatch() 等方法做后续处理。

使用场景:跨库同步、离线报表生成、审计日志写入等非主业务路径,不要求事务一致性或实时 JOIN。

  • 在模型中新建连接:$slave = new \mysqli('192.168.1.20', 'loguser', 'pass', 'logdb');
  • 执行原始查询:$result = $slave->query("SELECT * FROM events WHERE created_at > NOW() - INTERVAL 1 DAY");
  • 将结果转为数组后交给 CI4 的 Query Builder:$this->db->table('local_cache')->insertBatch($rows);
  • 务必手动关闭连接:$slave->close();,否则可能触发 MySQL “Too many connections” 错误

注意:mysqliPDO 需提前确认 PHP 已启用对应扩展,且字符集显式设为 utf8mb4,避免乱码。

CodeIgniter 4.7.0
CodeIgniter 4.7.0

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

下载

读写分离只能靠中间件或代理层实现

CI4 应用层无法自动识别 SELECTINSERT/UPDATE 并路由到不同库——它没有 SQL 解析器,也不挂钩执行前的 query hook。所谓“透明读写分离”,在 CI4 中必须外移。

推荐做法:用数据库代理(如 ProxySQL、MySQL Router)或负载均衡器(如 HAProxy)做 TCP 层路由,让所有应用请求发往代理地址,由代理按语句类型分发到主从节点。

  • 应用只需配置一个 database.default.hostname = "proxysql",完全无感
  • ProxySQL 支持基于正则匹配 SQL 类型、权重轮询、延迟检测、自动故障转移
  • 避免在 PHP 层做判断:PHP 解析 SQL 易出错(如注释里的 SELECT、字符串里的 UPDATE),且增加 CPU 开销
  • CI4 日志中看到的 Query: 记录仍是原始语句,不体现路由路径,调试需查 ProxySQL 日志

CI4 多环境数据库切换的真实限制

.env 支持通过 CI_ENVIRONMENT=production 切换环境,但 CI4 的 Database 类不会自动加载 database.production.* —— 它只认 database.default.*。所谓“多环境多库”,本质是不同环境部署时,人工替换 .env 中的 default 值。

容易踩的坑:

  • 误以为 database.development.hostnamedatabase.production.hostname 可共存于同一 .env 文件并自动生效 —— 实际只读 default 下的值
  • 用 Git 管理 .env 并提交敏感信息,正确做法是 .gitignore.env,用部署脚本注入环境变量
  • 在 Docker Compose 中用 environment: 覆盖 CI_ENVIRONMENT,却忘了同步注入 database.default.* 变量

真正需要隔离数据源时,别依赖框架配置切换,直接用不同域名或 IP 部署整套应用实例更稳妥。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

2205

3

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2023.08.14

3581

10

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

2023.08.31

2331

3

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

807

5

vb中怎么连接access数据库
vb中怎么连接access数据库

vb中连接access数据库的步骤包括引用必要的命名空间、创建连接字符串、创建连接对象、打开连接、执行SQL语句和关闭连接。本专题为大家提供连接access数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

2147

5

数据库对象名无效怎么解决
数据库对象名无效怎么解决

数据库对象名无效解决办法:1、检查使用的对象名是否正确,确保没有拼写错误;2、检查数据库中是否已存在具有相同名称的对象,如果是,请更改对象名为一个不同的名称,然后重新创建;3、确保在连接数据库时使用了正确的用户名、密码和数据库名称;4、尝试重启数据库服务,然后再次尝试创建或使用对象;5、尝试更新驱动程序,然后再次尝试创建或使用对象。

2023.10.16

2167

4

vb连接access数据库的方法
vb连接access数据库的方法

vb连接access数据库方法:1、使用ADO连接,首先导入System.Data.OleDb模块,然后定义一个连接字符串,接着创建一个OleDbConnection对象并使用Open() 方法打开连接;2、使用DAO连接,首先导入 Microsoft.Jet.OLEDB模块,然后定义一个连接字符串,接着创建一个JetConnection对象并使用Open()方法打开连接即可。

2023.10.16

2753

3

vb连接数据库的方法
vb连接数据库的方法

vb连接数据库的方法有使用ADO对象库、使用OLEDB数据提供程序、使用ODBC数据源等。详细介绍:1、使用ADO对象库方法,ADO是一种用于访问数据库的COM组件,可以通过ADO连接数据库并执行SQL语句。可以使用ADODB.Connection对象来建立与数据库的连接,然后使用ADODB.Recordset对象来执行查询和操作数据;2、使用OLEDB数据提供程序方法等等。

2023.10.19

1981

3

mdf文件导入数据库的方法
mdf文件导入数据库的方法

mdf文件导入数据库的方法有使用SQL Server Management Studio、使用SQL Server命令行工具、使用SQL Server Integration Services等方法。想了解更多mdf文件导入数据库的方法的相关内容,可以阅读本专题下面的文章。

2023.10.23

1993

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程