ThinkPHP配置DM8达梦数据库：国产化信创环境下的ThinkPHP无缝接入与调试

达梦数据库的PHP接入，看起来就是驱动安装、配置修改、连接测试这几个步骤，但真要把整套流程跑通，尤其还是在Windows上的PHPStudy环境里，往往就卡在一些意想不到的细节上。这里把几个最容易被忽视的坑点拆开来讲，希望能帮你节省一些排查时间。

PHP8线程安全版本必须匹配达梦驱动文件名

达梦的PHP驱动可不是随便扔进`ext`目录就能用的。最核心的一条铁律：`php80ts_dm.dll` 和 `pdots_dm.dll` 这两个文件的命名，必须跟你实际运行的PHP小版本、架构（x64还是x86）、以及线程模型（是否为TS）严丝合缝。很多人一看“PHP8”就去复制`php81ts_dm.dll`放到8.0.25的环境里，结果Apache直接罢工，`php -m`也报错`Unable to start DM module`。

怎么验证？几步就搞定：

• 命令行里敲一句 `php -v`，如果输出里能看到“(ZTS)”字样，那你的PHP就是线程安全版，没跑。
• 再用 `php --ini` 找到当前真正生效的`php.ini`文件路径。
• 打开它，加上两行：`extension=php80ts_dm` 和 `extension=pdots_dm`（注意，不带.dll后缀）。
• 重启PHPStudy的服务，然后在`phpinfo()`页面里搜索“dm”或“PDO Driver for DM”，看到它们才算成功。

如果还是不行，那八成是Windows下经典的DLL依赖问题。去达梦安装目录的`bin/`下把`dmdpi.dll`文件找出来，如果你是64位系统就复制到`C:WindowsSystem32`，32位系统则丢到`SysWOW64`目录下。这一步虽然古老，但很管用。

ThinkPHP6 的 database.php 配置要绕开 MySQL 惯性思维

千万别把达梦当MySQL来配。`type`值填`'dm'`只是基础，真正容易出问题的是下面这几个参数：

• `hostport`必须明确写成`'5236'`，就算你知道达梦默认就是这个端口，ThinkPHP的PDO构造器并不会帮你自动补齐，省略或留空都会导致连接失败。
• `charset`建议用`'utf8'`，而不是`'utf8mb4'`。达梦V8对`utf8mb4`的支持还不太完整，如果你有插入emoji或生僻字的需求，用`utf8mb4`很可能会报`Invalid character string format`。
• 关于`prefix`，如果你把它设成了空字符串`''`，那建表的时候千万注意别加双引号。达梦对大小写是敏感的，`think_user`和`THINK_USER`在它眼里是两个完全不同的对象。
• 最稳妥的做法是，在往ThinkPHP里配置之前，先单独用达梦自带的连接函数 `dm_connect(“127.0.0.1:5236”, “SYSDBA”, “xxx”)` 测一下，确认是数据库层面的问题还是ORM解析的问题，这样不会问题混在一起，排查起来更清晰。

中文乱码和字符集问题出在 dm_svc.conf，不是 php.ini

明明`php.ini`里已经设置了`default_charset = “UTF-8”`，但查询出来的中文全是问号或者乱码？问题大概率不出在PHP，而在达梦客户端层的字符映射上。这个配置的关键，是操作系统级的`dm_svc.conf`文件。

Windows下，这个文件要放在`C:Windows`目录里；Linux下则是`/etc/`。文件内容至少要有这两行：

CHAR_CODE=(PG_UTF8)LANGUAGE=(cn)

这里有两个关键点：

• `PG_UTF8`不是指PostgreSQL协议，它是达梦内部用来标识“兼容PostgreSQL的UTF-8编码行为”的一个开关，也是让达梦适配PHP PDO的关键所在。
• 这个配置文件很重要的一点是，它必须保存为ANSI编码，不能是UTF-8格式。否则达梦驱动会直接忽略它，导致配置不生效。
• 改完这个文件，不需要重启PHP进程，但一定要重启Apache或Nginx，让新的环境变量生效。

Dm Builder 类缺失会导致分页、子查询直接报错

这是最容易踩的一个坑。ThinkPHP6默认是没有达梦专用的SQL构建器的，所以像`limit`、`order by`、`union`这些操作，它生成的SQL都会沿用MySQL的那一套。而达梦的分页语法用的是`rownum`伪列嵌套，如果不重写构建逻辑，一调用`paginate()`方法，结果不是返回空就是直接报错`ORA-00904: “ROWNUM” invalid identifier`。

这一步没法偷懒，必须手动补上两个核心类：

• 新建一个`Builder`类，比如放在`app/common/db/builder/Dm.php`（路径可以自定义），让它继承`thinkdbBuilder`，然后重写里面的`$selectSql`模板和`parseLimit`方法，把分页逻辑改成达梦的`rownum`语法。
• 再新建一个`Connection`类，放在`app/common/db/connection/Dm.php`，在这个类里指定刚才写好的`Dm Builder`作为构建器。
• 最后，在`config/database.php`里，找到`connections.dm`这个配置项，加一行：`'builder' => appcommondbbuilderDm::class`。

别看现在只是查个`select * from user`没问题，一旦你的业务逻辑涉及到分页、排序或者关联查询，这个问题就会立刻暴露出来。所以，在这个问题上提前做好准备，能省去后面很多麻烦。