不能直接 return $query->result()，因为会提前释放查询资源导致后续无法调用num_rows()等方法，且无法统一返回结构；正确做法是保存$query对象，按需提供get_rows()、count()等方法。
为什么不能直接 return $query->result() 作为自定义类返回值
CodeIgniter 的 $query->result() 返回的是对象数组，但很多业务场景需要统一结构（比如带分页元信息、统一字段名、空结果兜底），直接裸返会让调用方反复做类型判断和格式转换。更麻烦的是，如果在自定义类里没保留原始 $query 对象或连接状态，后续想追加 num_rows() 或 row_array() 就会失败——因为 result() 执行后资源已释放。
封装时必须保留 Query 对象而非提前取结果
正确做法是把 $query 实例存为类属性，暴露方法按需取数据，而不是构造时就执行 result()。这样既能复用查询结果，又能支持多种输出格式：
- 类内部保存
$this->query = $query;（不是$this->data = $query->result();） - 提供
get_rows()返回$this->query->result() - 提供
get_row()返回$this->query->row() - 提供
count()返回$this->query->num_rows() - 提供
to_array()返回$this->query->result_array()
示例片段：
class ResultWrapper {
protected $query;
public function __construct($query) {
$this->query = $query;
}
public function get_rows() {
return $this->query->result();
}
public function count() {
return $this->query->num_rows();
}
}
注意 CI 版本对 result() 返回类型的差异
CI3 和 CI4 的 result() 行为不同：CI3 默认返回 stdClass 对象数组；CI4 的 getResult() 默认返回关联数组（getResultArray() 才是对象）。如果你的封装类要跨版本兼容，得显式指定返回类型：
- CI3 中可用
$query->result('array')强制返回数组 - CI4 中用
$query->getResultObject()确保是对象 - 避免依赖默认行为，否则上线后查不到数据却没报错
别在封装类里自动调用 free_result() 或 close()
CodeIgniter 查询对象的生命周期由数据库驱动管理，手动调用 free_result() 会导致后续 num_rows() 返回 0，甚至引发 Fatal error: Call to a member function num_rows() on bool。封装类只负责“包装”，不负责“销毁”。只要不显式调用，CI 在请求结束时会自动清理。
真正容易被忽略的是：如果自定义类做了缓存（比如把 $query->result() 存到静态变量），又没清空，下次请求可能拿到旧数据。所以缓存逻辑必须配合 CI 的生命周期（如使用 get_instance()->cache），而不是靠类内 static 变量硬存。
