ThinkPHP 5.1 编写自定义的数据库连接器（Connector）【底层】

在 ThinkPHP 5.1 的生态里，想接入达梦、人大金仓这类非标准数据库，或者为自定义协议的嵌入式存储实现原生支持，不能直接走内置的 PDO/MySQLi 封装层——必须从底层编写一个专门的 Connector 类。它的核心职责就是建立连接、传递配置，最后返回一个能被 `Db` 类接受的 `Connection` 实例，同时不破坏框架的查询构建器与事务管理机制。这件事听起来有点绕，但搞清楚了会发现其实并不复杂。

理解 Connector 的职责边界

先理清框架的三层结构：ThinkPHP 5.1 的 `Db` 类通过 **Driver → Connector → Connection** 把数据库操作解耦开来。Driver 管 SQL 语法和方言，Connector 管连接初始化，Connection 管执行逻辑。自定义 Connector 不需要碰 SQL 编译，也不用自己实现 `query()` 方法——它只用做一件事：根据传入的配置数组，返回一个已经连接好、并且能被 `Db::connect()` 正确接收的 `Connection` 对象实例。 这里有个关键点：如果跳过 Connector 直接 `new Connection`，事务就没法挂载到 `Db` 类的全局连接池里，后续调用 `startTrans()` 会直接失效。所以这一步不是墙上的钉子，是绕不过去的正路。

创建 Connector 类文件

在 `application/common/connector/` 目录下新建一个文件，比如针对国产达梦数据库，可以命名为 `Daruma.php`： - 文件路径必须是 `application/common/connector/Daruma.php` - 类名必须为 `Daruma`，并且继承 `think\db\connector\Connector` - 为什么这么严格？框架通过反射自动加载时，会拿类名去匹配驱动配置中的 `type` 值，名字对不上就找不到了。 文件放进去之后，就可以开始重写核心方法了。

重写 connect 方法

在 `Daruma.php` 里，覆盖父类的 `connect()` 方法，有两种主流方式可以实现。 **方法一：使用原生达梦 PHP 扩展 `dm8`** 第一步：检查扩展是否加载。如果 `extension_loaded('dm8')` 返回 `false`，直接抛出异常，别让后面的代码跑起来。 第二步：用 `dm_connect()` 建立底层的连接。传进配置里的 `hostname`、`database`、`username`、`password`、`hostport`——注意达梦的默认端口是 5236，不是 3306，写错了就连不上。 第三步：设置字符集。这一步特别重要：必须执行 `dm_query($link, "SET NAMES {$config['charset']}")`，否则中文入库会变成乱码，而且这个乱码不可逆。 第四步：返回一个 `think\db\connection\Mysql` 实例。这里是一个很多人都不知道的“巧活儿”——达梦的 SQL 语法与 MySQL 高度兼容，所以复用 `Mysql Connection` 类可以直接支撑 `query()`、`execute()`、事务的 `begin/commit/rollback`，完全不用自己再重写 Connection。 **方法二：使用 PDO_DM（需要提前编译安装 `pdo_dm` 扩展）** 构造 DSN 字符串：`'dm:server={$config["hostname"]};port={$config["hostport"]};dbname={$config["database"]}'`。这里要注意，`port` 参数不能漏掉，达梦 PDO 驱动不会自动推断默认端口，少写了就是“连不上”。

注册并配置驱动

在 `database.php` 配置文件中添加一个新的数据库连接定义： ``` 'daruma' => [ 'type' => 'daruma', 'hostname' => '127.0.0.1', 'database' => 'MYDB', 'username' => 'SYSDBA', 'password' => 'SYSDBA', 'hostport' => 5236, 'charset' => 'UTF-8', ], ``` 然后在数据库配置顶部把 `'default'` 设为 `'daruma'`，或者在调用时显式使用 `Db::connect('daruma')`。做完这一系列操作后，`Db::table('user')->select()` 就会自动走你写的 `Daruma Connector`——建立连接、返回复用 `Mysql Connection` 的实例，整个流程完整跑通。