17370845950

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 的人，别碰自定义驱动。