不能直接继承 ci_db_driver 扩展数据库方法,因其是运行时动态生成的抽象代理壳,非设计用于继承的基类;正确方式是通过 my_db 子类化或驱动扩展。

不能直接继承 CI_DB_driver 来扩展数据库方法——它不是设计给你继承的基类,而是运行时动态生成的抽象代理壳。
为什么继承 CI_DB_driver 会失败
CI 2.x/3.x 的数据库类初始化过程是硬编码 + eval() 构建的:CI_DB 类根本不存在于文件系统中,它是在 DB() 函数里根据 $active_record 配置,用 eval 动态声明的子类(继承自 CI_DB_active_record 或 CI_DB_driver)。你写的 class My_db extends CI_DB_driver 在加载时找不到父类定义,因为 CI_DB_driver 只在 DB_driver.php 中被 require_once,且不支持直接实例化或继承使用。
-
CI_DB_driver没有构造函数签名兼容性保障,其__construct()依赖内部参数传递链,外部继承会破坏初始化流程 - 所有数据库操作最终都走
$this->db实例,而该实例是CI_DB(动态类)的实例,不是你自定义类的实例 - 即使类定义通过,调用
$this->db->my_method()也会报Call to undefined method,因为方法没注入到实际运行的CI_DB实例上
正确扩展数据库行为的两种路径
真正可行的方式只有两个:一是通过驱动扩展(driver),二是通过数据库类别名替换(subclass)。
- 驱动扩展适用于新增一种数据库后端(比如加个
sqlite3或redis作为“数据库”类型),需遵循drivers/目录约定,且必须实现initialize()、query()等核心接口 - subclass 方式才是扩展已有 MySQL/PostgreSQL 行为的标准做法:在
application/core/下创建MY_DB.php,类名必须是MY_DB(前缀由$config['subclass_prefix']决定,默认MY_),并继承CI_DB——注意,不是CI_DB_driver -
MY_DB类会在DB()初始化后被自动识别并用于构建$this->db实例,此时你添加的 public 方法(如insert_batch_ignore())才能被调用
MY_DB.php 的最小可行写法
确保 application/config/config.php 中已设 $config['subclass_prefix'] = 'MY_';,然后创建 application/core/MY_DB.php:
<?php defined('BASEPATH') OR exit('No direct script access allowed');
class MY_DB extends CI_DB {
public function insert_ignore($table, $data)
{
$sql = $this->_insert_ignore($table, $data);
return $this->query($sql);
}
protected function _insert_ignore($table, $data)
{
// 复用 CI_DB_driver 已有逻辑,只改 SQL 拼装
$fields = array_keys($data);
$values = array_values($data);
$sql = "INSERT IGNORE INTO " . $this->escape_identifiers($table) . " ("
. implode(', ', array_map([$this, 'escape_identifiers'], $fields))
. ") VALUES (" . implode(', ', array_fill(0, count($values), '?')) . ")";
return $this->set_bind_markers()->compile_binds($sql, $values);
}
}
- 不要重写
__construct(),让父类逻辑完整执行 - 新增方法尽量复用
$this上已有的私有方法(如_insert()、escape_identifiers()),避免重复造轮子 - 如果要改查询执行前的行为(比如统一加 tenant_id 过滤),可重写
query(),但务必调用parent::query()并处理返回值
容易被忽略的加载时机问题
MY_DB 不是靠 $this->load->library() 加载的,它在 DB() 函数执行时自动介入。这意味着:
- 你不能在控制器里先
$this->load->database()再去改MY_DB的属性——此时实例已创建完毕 - 所有对
$this->db的增强方法,必须在MY_DB类定义里完成,且只能在application/core/下,不能放在libraries/ - 若用了 HMVC(如 Modular Extensions),每个模块的
DB()调用仍会走同一套MY_DB,无需额外配置
真正卡住人的地方从来不是语法,而是 CI 把数据库类做成「一次性 eval 构建 + 单例绑定」这个设计——你得顺着它的生命周期插,而不是站在外面想继承就继承。











