讲师中心 微信公众号
AI工具推荐 视频效率加速

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

云婷同学_3403

云婷同学_3403

发布时间:2026-06-22 13:56:08

|

964人浏览过

|

来源于php中文网

原创

PHP8线程安全版本需严格匹配达梦驱动文件名,如php80ts_dm.dll与pdots_dm.dll必须与PHP小版本、架构(x64/x86)、线程模型(TS)完全一致;验证需通过php -v确认ZTS,php --ini定位php.ini并添加extension=php80ts_dm和extension=pdots_dm,复制dmdpi.dll至系统目录,ThinkPHP6配置type='dm'、hostport='5236'、charset='utf8',且须配置ANSI编码的dm_svc.conf启用CHAR_CODE=(PG_UTF8),并自定义Dm Builder类适配rownum分页语法。

thinkphp配置dm8达梦数据库:国产化信创环境下的thinkphp无缝接入与调试

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

达梦PHP驱动不是“装上就能用”,php80ts_dm.dll 和 pdots_dm.dll 必须与你实际运行的PHP小版本、架构(x64/x86)、线程模型(TS)完全一致。常见错误是看到“PHP8”就复制 php81ts_dm.dll 到 PHP 8.0.25 TS 环境里,结果 Apache 启动失败或 php -m 报 Unable to start DM module。

验证方式很简单:

  • 运行 php -v 看到类似 PHP 8.0.25 (cli) (built: ... ) ( ZTS ) —— 表明是 TS 版
  • 运行 php --ini 找到真实生效的 php.ini 路径
  • 在该 php.ini 中添加两行:extension=php80ts_dm 和 extension=pdots_dm(不带 .dll 后缀)
  • 重启 PHPStudy 服务后,访问 phpinfo() 页面搜索 dm 或 PDO Driver for DM

若仍失败,把达梦安装目录 bin/ 下的 dmdpi.dll 复制到 C:\Windows\System32(64位系统)或 SysWOW64(32位 PHP),这是 Windows 下 DLL 依赖未解析的典型表现。

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

达梦不是 MySQL,type 值填 'dm' 是前提,但更关键的是几个易错参数:

立即学习“PHP免费学习笔记(深入)”;

  • hostport 必须显式写成 '5236',不能省略或写成 '';达梦默认端口虽是 5236,但 ThinkPHP 的 PDO 构造器不自动 fallback
  • charset 推荐设为 'utf8',不是 'utf8mb4' —— 达梦 V8 对 utf8mb4 支持不完整,否则插入 emoji 或某些生僻字会报错 Invalid character string format
  • prefix 若为空字符串 '',必须确认建表时没加双引号;达梦对大小写敏感,默认创建的表名是大写,think_user 和 THINK_USER 是两个对象
  • 连接测试时,先用 dm_connect("127.0.0.1:5236", "SYSDBA", "xxx") 单独跑通,再进 TP6,避免把连接问题和 ORM 解析问题混在一起

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

即使 php.ini 设了 default_charset = "UTF-8",TP6 查询返回中文仍是问号或方块,大概率是达梦客户端层的字符映射没对齐。这个配置不在 PHP,而在操作系统级的 dm_svc.conf 文件。

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

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

下载

Windows 下该文件需放在 C:\Windows\ 目录;Linux 下放在 /etc/。内容至少包含:

CHAR_CODE=(PG_UTF8)
LANGUAGE=(cn)

注意两点:

  • PG_UTF8 是达梦内部标识,不是 PostgreSQL 协议 —— 它表示“兼容 PostgreSQL 的 UTF8 编码行为”,这是达梦适配 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 类错误。

必须手动补全两个类:

  • 在 app/common/db/builder/Dm.php(路径可自定义)中新建 Builder 类,继承 think\db\Builder,重写 $selectSql 模板和 parseLimit 方法
  • 在 app/common/db/connection/Dm.php 中新建 Connection 类,指定 builder 为刚写的 Dm Builder
  • 最后在 config/database.php 的 connections.dm 配置项里加上:'builder' => \app\common\db\builder\Dm::class

这一步没法跳过,哪怕只是简单 select * from user 也不影响,一旦涉及分页、排序、关联查询,就会暴露。

相关文章

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

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

下载

相关标签:

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

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

10184

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

6021

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2095

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3788

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4474

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3511

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5017

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3922

2023.11.13

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn