CodeIgniter 不原生支持 DataMapper，其 Query Builder 仅构建 SQL，不提供实体类或 ORM 映射；所谓“实体类”需自行封装或引入第三方库（如 datamapper-ci），否则 new User() 会因绕过 CI 加载机制导致 $this->db 未初始化而报错。
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 nullUndefined 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 已加载
}
<pre class="brush:php;toolbar:false;">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 + 手动数组映射——因为够用、可控、出问题能一眼看到哪行代码在作祟。
