CodeIgniter实体类使用方法｜数据映射技巧分享

CodeIgniter 本身并不原生支持实体类或 ORM 映射，其 Query Builder 仅负责 SQL 构建与执行，因此所谓“使用实体类”实为开发者自行封装模型或引入第三方 DataMapper 扩展（如 datamapper-ci）的权宜之计；直接 new User() 会因绕过 CI 的加载机制导致数据库实例未初始化而报错，正确做法是让实体类继承 CI_Model 并在构造函数中显式加载数据库，同时注意输入数据的类型转换、日期标准化和布尔值安全处理；随着 CI 3.x 强调轻量定位，DataMapper 因缺乏命名空间支持、调试困难、批量操作性能差等缺陷已逐渐被弃用，现代实践中更推荐以 CI 为应用层框架，搭配 Doctrine DBAL 或 Eloquent 等成熟 ORM 实现真正的数据映射，或回归简洁可控的手动数组映射模式。

DataMapper 在 CodeIgniter 中不是原生组件，官方 Active Record（现称 Query Builder）只负责 SQL 构建与执行，不提供实体类（Entity Class）或自动 ORM 映射。所谓“使用实体类”，实际是开发者自行封装或引入第三方扩展实现的——最常见的是基于 DataMapper ORM 库（如 datamapper-ci），或手动构建轻量级模型类。

你遇到的错误 system/database/db_driver.php line number: 1，大概率是因为未正确加载 DataMapper 类，或其构造逻辑与 CI 2.x/3.x 的生命周期冲突（比如在 __construct() 中直接 new 实例但未初始化数据库连接）。

为什么直接 new user() 会报错？

CodeIgniter 的对象生命周期由 CI_Loader 管理，所有依赖（如数据库）需通过 $this->load->database() 显式加载。而 new user() 是纯 PHP 实例化，绕过了 CI 的加载机制，导致内部调用 $this->db 时为 null 或未初始化。

常见表现：

• Fatal error: Call to a member function query() on null
• Undefined property: user::$db
• 报错位置跳转到 db_driver.php 第 1 行——其实是上层调用失败后触发的兜底 fatal

如何让 user 类真正访问数据库？

必须让实体类能拿到 CI 的实例上下文。有两条可行路径：

• 继承 DataMapper 基类（如使用 datamapper-ci 扩展），它内部会自动调用 get_instance() 获取当前 CI 对象
• 手动注入：在模型中定义 __construct()，显式获取 CI 实例并绑定 $this->db

示例（手动方式，适用于 CI 2.x/3.x）：

class User extends CI_Model
{
    public function __construct()
    {
        parent::__construct();
        $this->load->database(); // 确保 db 已加载
    }
public function save($data)
{
    return $this->db->insert('users', $data);
}
}

注意：User 不是“纯粹实体”，而是 CI 风格的模型——它依赖框架生命周期，不能脱离 CI 环境独立 new。

映射字段时容易忽略的类型转换

CI 的 $this->input->post() 返回字符串，直接插入整型/浮点字段会出问题。例如 'Qty' => $this->input->post('Qty') 插入数据库后可能存成 '0' 或触发严格模式报错。

• 整数字段务必强制转换：(int)$this->input->post('Qty')
• 小数字段用 (float) 或 floatval()，避免科学计数法干扰
• 日期字段别依赖前端传来的字符串，用 strtotime() + date('Y-m-d H:i:s') 标准化
• 布尔字段（如 is_active）不能只靠 isset($_POST['is_active'])，要显式判断：!empty($this->input->post('is_active')) ? 1 : 0

CI 3.x 后不推荐 DataMapper 的真实原因

CI 3.x 开始强化了轻量定位，官方明确不内置 ORM。而 DataMapper 类库存在几个硬伤：

• 不支持命名空间，与现代 PHP 自动加载（PSR-4）天然冲突
• 单例式数据库连接管理，在 CLI 模式或长连接场景下易出现事务残留
• 字段映射靠魔术方法（__set/__get），调试困难，IDE 无法跳转属性定义
• 批量操作（如 save_all()）底层仍是逐条 query，无真正的 prepare/batch 支持

如果你真需要实体+ORM，更稳妥的做法是：用 CI 做路由和基础加载，把数据层换成 Doctrine DBAL 或 Eloquent（通过 Composer 加载），而不是硬塞 DataMapper 进 CI 生命周期。

实际项目里，多数人最后都退回用 CI_Model + 手动数组映射——因为够用、可控、出问题能一眼看到哪行代码在作祟。

以上就是《CodeIgniter实体类使用方法｜数据映射技巧分享》的详细内容，更多关于CodeIgniter的资料请关注golang学习网公众号！