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

落宇姑娘_9233

落宇姑娘_9233

2026-07-11

512人浏览

原创

必须编写自定义connector类(如daruma)继承think\db\connector\connector,重写connect()方法建立达梦等非标数据库连接并返回兼容mysql connection实例,再在database.php中注册驱动配置,才能在不破坏查询构建器与事务机制前提下实现原生支持。

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() 建立连接 → 传入 $config['hostname']、$config['database']、$config['username']、$config['password']、$config['hostport'](注意达梦默认端口是 5236,不是 3306)。

第三步:设置字符集 → 必须执行 dm_query($link, "SET NAMES {$config['charset']}"),否则中文入库乱码;【若未执行此步,后续所有 INSERT 都将写入乱码,且不可逆】。

第四步:返回 think\db\connection\Mysql 实例 → 这里是关键 trick:达梦 SQL 语法与 MySQL 高度兼容,复用 Mysql Connection 类可直接支持 query()、execute()、事务 begin/commit/rollback,无需重写 Connection。

方法二:使用 PDO_DM(需提前编译安装 pdo_dm 扩展)

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

构造 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 的实例。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

thinkphp php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

2505

3

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2023.08.14

3781

10

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

2023.08.31

2731

3

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

907

5

vb中怎么连接access数据库
vb中怎么连接access数据库

vb中连接access数据库的步骤包括引用必要的命名空间、创建连接字符串、创建连接对象、打开连接、执行SQL语句和关闭连接。本专题为大家提供连接access数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

2447

5

数据库对象名无效怎么解决
数据库对象名无效怎么解决

数据库对象名无效解决办法:1、检查使用的对象名是否正确,确保没有拼写错误;2、检查数据库中是否已存在具有相同名称的对象,如果是,请更改对象名为一个不同的名称,然后重新创建;3、确保在连接数据库时使用了正确的用户名、密码和数据库名称;4、尝试重启数据库服务,然后再次尝试创建或使用对象;5、尝试更新驱动程序,然后再次尝试创建或使用对象。

2023.10.16

2447

4

vb连接access数据库的方法
vb连接access数据库的方法

vb连接access数据库方法:1、使用ADO连接,首先导入System.Data.OleDb模块,然后定义一个连接字符串,接着创建一个OleDbConnection对象并使用Open() 方法打开连接;2、使用DAO连接,首先导入 Microsoft.Jet.OLEDB模块,然后定义一个连接字符串,接着创建一个JetConnection对象并使用Open()方法打开连接即可。

2023.10.16

2813

3

vb连接数据库的方法
vb连接数据库的方法

vb连接数据库的方法有使用ADO对象库、使用OLEDB数据提供程序、使用ODBC数据源等。详细介绍:1、使用ADO对象库方法,ADO是一种用于访问数据库的COM组件,可以通过ADO连接数据库并执行SQL语句。可以使用ADODB.Connection对象来建立与数据库的连接,然后使用ADODB.Recordset对象来执行查询和操作数据;2、使用OLEDB数据提供程序方法等等。

2023.10.19

2241

3

mdf文件导入数据库的方法
mdf文件导入数据库的方法

mdf文件导入数据库的方法有使用SQL Server Management Studio、使用SQL Server命令行工具、使用SQL Server Integration Services等方法。想了解更多mdf文件导入数据库的方法的相关内容,可以阅读本专题下面的文章。

2023.10.23

2373

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程