达梦数据库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 版本：
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 驱动转发请求。关键不在“连上”，而在“驱动链路不中断”。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先装 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 错误里不会体现，只会静默失败。
