达梦数据库在thinkphp6中需手动部署php扩展、补全dm builder和connection类，并严格匹配ts版dll与php版本；配置type=>'dm'， charset用utf-8，表名大写，还需安装odbc驱动及验证客户端连通性。
dm 驱动在 ThinkPHP6 中不能直接开箱即用，必须手动部署 PHP 扩展 + 补全框架缺失的 Builder 和 Connection 类，否则会报 PDOException: could not find driver 或 SQL 语法错误。
确认 PHP 环境是否满足达梦驱动加载条件
达梦 php80ts_dm.dll 只认线程安全（TS）版 PHP，且版本号必须精确匹配。比如你用的是 PHP 8.1.18 TS，就不能用 php80ts_dm.dll，得换 php81ts_dm.dll。Windows 下通过 PHPStudy 启动 Apache 时，若看到 500 Internal Server Error 或 Call to undefined function pdo_drivers()，大概率是 TS/NTS 混搭或 DLL 版本错位。
验证方式很简单：
- 运行
php -i | findstr "Thread Safety"（Windows）或php -i | grep "Thread Safety"（Linux/macOS），输出enabled才是 TS - 执行
php -m | grep dm，有输出说明扩展已加载；无输出就回去检查php.ini里的extension=php81ts_dm和extension=pdots_dm是否写对、路径是否存在 -
dmdpi.dll必须放在 PHP 运行目录（如phpstudy_pro\Extensions\php\php8.1.18ts根目录），不是ext目录——放错位置会导致Unable to load dynamic library
ThinkPHP6 的 config/database.php 必须显式声明 type => 'dm'
ThinkPHP6 不像 Laravel 那样自动识别 DSN 协议前缀，它靠 type 字段决定调用哪个数据库驱动类。如果只写 type => 'pdo' 或漏掉 type，框架会 fallback 到 MySQL 的 Builder，生成的 SQL 里带反引号（`user`）、LIMIT 用 LIMIT 10 OFFSET 20，而达梦根本不认这些语法，直接报错 Invalid character 或 SQL syntax error。
正确配置示例如下：
'dm' => [
'type' => 'dm',
'hostname' => '127.0.0.1',
'database' => 'MYDB',
'username' => 'SYSDBA',
'password' => 'SYSDBA',
'hostport' => '5236',
'charset' => 'UTF-8',
'prefix' => '',
'debug' => true,
],
注意三点：
-
charset建议写UTF-8（全大写带短横），达梦对utf8兼容性不稳定，某些版本会忽略导致中文乱码 -
prefix如果为空字符串，不要省略，否则框架可能拼出FROM .table_name这种非法语句 - 连接成功后，首次查询若报
ORA-00942: table or view does not exist，先确认表名是否全大写（达梦默认大写对象名），再检查是否漏了SCHEMA，比如SELECT * FROM MYDB.USER_INFO而非USER_INFO
必须补全 think-orm 缺失的达梦专属 Builder 类
ThinkPHP6 的 vendor/topthink/think-orm/src/db/builder 目录下没有 Dm.php，导致 ORDER BY + LIMIT、子查询别名、分页等全部失效。不加这个类，$query->limit(10, 20) 生成的还是 MySQL 风格 SQL，达梦直接拒绝执行。
你需要手动创建 app/db/builder/Dm.php（路径可自定义，但需确保自动加载能覆盖原路径），内容核心是重写 $selectSql 和 parseLimit：
protected $selectSql = 'SELECT * FROM (SELECT %DISTINCT% %FIELD% FROM %TABLE%%JOIN%%WHERE%%GROUP%%HAVING%%ORDER%) AS t1 WHERE ROWNUM 1) {
// 达梦分页：先取前 N+M 行，再跳过前 N 行
$offset = (int) $limit[0];
$length = (int) $limit[1];
return 'ROWNUM BETWEEN ' . ($offset + 1) . ' AND ' . ($offset + $length);
}
return 'ROWNUM <p>这个类还必须在 <code>Connection</code> 中被引用，所以你还得复制一份 <code>app/db/connector/Dm.php</code>，继承 <code>Connection</code> 并覆写 <code>getBuilder</code> 方法，返回你刚写的 <code>Dm</code> Builder 实例。否则框架仍用默认 MySQL Builder。</p><h3>连接测试时最容易忽略的两个底层依赖</h3><p>即使 PHP 扩展和 ThinkPHP 配置都对了，<code>new PDO('dm:host=127.0.0.1;port=5236;dbname=MYDB', 'SYSDBA', 'SYSDBA')</code> 仍可能抛 <code>SQLCODE = -2602</code> 或直接超时。这不是代码问题，而是两个系统级依赖没到位：</p>
- 达梦客户端工具（
disql或管理工具）必须能连上目标库，否则 PHP 驱动也连不上；先用它验证账号密码、端口、实例名是否正确 - Windows 上必须安装达梦 ODBC 驱动（
DM8_ODBC_x64.msi），并注册为系统 DSN；PHP 的php81ts_dm.dll内部依赖 ODBC 层通信，不装它，pdo_dm就是空壳 - Linux 下则要确认
LD_LIBRARY_PATH包含$DM_HOME/bin，且libdmdpi.so权限为 755，否则php -m看得到模块，但运行时报undefined symbol: dpi_connect
达梦适配真正的难点不在 PHP 侧，而在驱动链路太长：PHP 扩展 → ODBC 层 → 达梦网络协议 → 实例服务。任一环断开，表现都是“连不上”，但原因各不相同。建议每次改动只动一个点，用 php -r "new PDO('dm:host=127.0.0.1;port=5236;dbname=MYDB', 'SYSDBA', 'SYSDBA');" 命令行最小化验证，比跑整个 ThinkPHP 请求更快定位问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
