Yii 的 db 组件不支持达梦等国产数据库,因官方仅维护四种驱动,其余需手动实现 Connection、Schema、QueryBuilder 三类并注册;推荐直接使用 createCommand 执行原生 SQL 避开适配问题。

Yii 的 db 组件不是“抽象层”,而是基于 PDO 的轻量级数据库访问封装,它不试图屏蔽 SQL 差异,也不提供跨数据库的语法翻译 —— 这意味着它适配新数据库的能力,完全取决于你是否愿意写适配代码。
为什么 yii\db\Connection 不自动支持达梦、人大金仓等国产库
Yii 官方只维护 mysql、pgsql、sqlite、mssql 四种驱动,其余数据库(如 dm、kingbase、shentong)需自行实现 yii\db\Driver 子类并注册到 yii\db\ConnectionFactory。官方不提供,社区也极少维护,因为 Yii 的设计哲学是“SQL 优先”,而非“ORM 优先”。
- 驱动缺失时,
Unknown driver: dm错误直接抛出,不会 fallback - 即使手动注册了 PDO DSN(如
dm:host=127.0.0.1;port=5236;dbname=test),QueryBuilder和Schema仍会因缺少对应实现而报错 -
yii\db\pgsql\Schema里硬编码了pg_get_serial_sequence这类函数,国产库无法复用
createCommand() 执行原生 SQL 是最稳的用法
绕过 QueryBuilder 和 ActiveRecord,直接走 PDO,能避开 90% 的适配问题。尤其在对接非标准数据库时,这是推荐路径。
- 用
$connection->createCommand($sql, $params)->execute()替代ActiveRecord::find()->where(...) - 避免使用
insert()、upsert()等依赖QueryBuilder的方法 —— 它们在非标库上大概率触发NotSupportedException - 建表、索引、序列等 DDL 操作必须手写 SQL,
createTable()方法只对四种官方驱动做语义映射
return $this->db->createCommand("INSERT INTO user_log (uid, action) VALUES (:uid, :act)", [
':uid' => $uid,
':act' => 'login',
])->execute();
自定义驱动要重写的三个核心类
若真要让达梦或 OceanBase 被 Yii “认作”一个合法数据库类型,至少补全以下三部分:
-
yii\db\dm\Connection:继承yii\db\Connection,覆盖initConnection()处理连接参数(如charset映射为client_encoding) -
yii\db\dm\Schema:继承yii\db\Schema,重写findTableNames()、loadTableSchema(),适配系统表查询语句(达梦查USER_TABLES,OceanBase 查oceanbase.__all_table) -
yii\db\dm\QueryBuilder:继承yii\db\QueryBuilder,重写buildOrderBy()、quoteValue()等 —— 尤其注意分页语法:LIMIT ? OFFSET ?在达梦中要转成ROWNUM BETWEEN ? AND ?
真正麻烦的不是连上数据库,而是 Schema 发现和 SQL 构建这两个环节 —— 它们强耦合目标库的系统视图结构与方言特性。没耐心啃文档、调底层 SQL 的人,别碰自定义驱动。









