达梦数据库PHP官方驱动dm_php仅支持PHP 7.0–7.4，不兼容PHP 8.x；推荐使用PDO_ODBC方案，需正确配置unixODBC、达梦ODBC驱动及DSN，并注意字符集与依赖库完整性。

达梦数据库的 PHP 官方驱动是否可用

达梦官方确实提供 PHP 扩展驱动 dm_php，但仅支持 PHP 7.0–7.4（截至达梦 8.1.3.129 版本），且不支持 PHP 8.x。如果你用的是 PHP 8.0+，dm_php 编译会失败，运行时直接报 undefined symbol: zend_empty_string 类错误——这不是配置问题，是 ABI 不兼容。

实操建议：

• 确认 PHP 版本：php -v；若 ≥ 8.0，跳过官方扩展，改用 PDO + ODBC 方案
• 下载匹配版本的达梦客户端（DmInstall.bin 或绿色版 dm8_client），必须包含 libdmdc.so 和 libdmdb.so
• 官方扩展源码在达梦安装目录 /dmdbms/drivers/php/ 下，但需手动 phpize && ./configure && make && make install，失败率高，不推荐新手硬刚

PDO_ODBC 连接达梦的实际步骤

这是目前最稳定、跨 PHP 版本的方案，本质是让 PDO 走 ODBC 通道，再由达梦 ODBC 驱动转发请求。关键不在“连上”，而在“驱动链路不中断”。

实操建议：

• 先装 unixODBC：sudo apt install unixodbc unixodbc-dev（Ubuntu）或 yum install unixODBC-devel（CentOS）
• 把达梦 ODBC 驱动（libdodbc.so）路径写进 /etc/odbcinst.ini，例如：

  [DAMENG]
  Description = DAMENG ODBC Driver
  Driver = /opt/dm8/bin/libdodbc.so
  Setup = /opt/dm8/bin/libdodbc.so
  FileUsage = 1

• 在 /etc/odbc.ini 中配 DSN：

  [DM8_TEST]
  Description = DM8 test db
  Driver = DAMENG
  Server = 127.0.0.1
  UID = SYSDBA
  PWD = SYSDBA
  Port = 5236
  Database = DMSERVER

• PHP 中连接：$pdo = new PDO('odbc:DSN=DM8_TEST', '', '');，注意：用户名密码已写在 DSN 里，PDO 构造函数后两个参数留空，否则会重复认证报错

常见连接失败原因和对应检查点

报错不是随机的，每类错误对应一个确定环节断开。别一上来就查 PHP 配置，先顺链路排查。

典型现象与对策：

• SQLSTATE[IM002] SQLDriverConnect: 0 [unixODBC][Driver Manager]Data source name not found → 检查 odbc.ini 中 DSN 名是否和 PDO 字符串里的一致，大小写敏感
• SQLSTATE[08001] [unixODBC]Unable to connect to data source → 达梦服务没启，或 Server/Port 写错；用 disql SYSDBA/SYSDBA@localhost:5236 先本地验证
• Segmentation fault 或 PHP 进程崩溃 → libdodbc.so 和当前系统 glibc 版本不匹配，换达梦客户端小版本（如从 8.1.3.129 换成 8.1.2.111）
• 中文乱码 → 在 DSN 后加 ;CharSet=UTF-8，即：odbc:DSN=DM8_TEST;CharSet=UTF-8，且达梦库字符集需为 UTF-8（建库时指定）

为什么不用 mysqli 或 pgsql 类扩展模拟

达梦不兼容 MySQL 协议，也不兼容 PostgreSQL 协议。所有试图用 mysqli_connect() 或 pg_connect() 去连达梦端口的行为，都会在 TCP 握手后立刻被拒绝，返回类似 Unknown MySQL Server Host 或空响

根本原因在于协议层不互通：达梦用自研的 DMTCP 协议，握手包结构、认证流程、SQL 报文编码都不同。强行复用其他扩展，等于拿 USB-C 线插 Lightning 接口——物理能插，但没信号。

所以，绕过协议直连的唯一可行路径只有两条：官方 PHP 扩展（限老版本 PHP）或 ODBC（通用但需配驱动）。没有第三条捷径。

ODBC 配置里最容易被忽略的是 libdodbc.so 的依赖链——它依赖 libdmdc.so 和 libdmasm.so，缺任何一个，isql -v DM8_TEST 就会报 error while loading shared libraries，但 PHP 错误里不会体现，只会静默失败。