达梦数据库PHP连接字符集不生效的主因是连接层未透传字符集参数,需在DSN中正确设置charset=UTF-8(dm8扩展)或通过odbc.ini配置CharacterSet=UTF-8(pdo_odbc),并确保服务端、表定义、PHP文件编码三者一致。

php连接达梦数据库时字符集不生效的常见原因
达梦(DM)默认使用 GB18030,而 PHP 的 pdo_odbc 或 dm8 扩展若未显式指定字符集,容易出现中文乱码、插入截断或查询为空——这不是 PHP 侧编码问题,而是连接层未把字符集参数透传给 DM 服务端。
用 dm8 官方扩展时设置 charset 参数
达梦官方提供的 dm8 扩展(非 ODBC)支持连接字符串中直接指定字符集,这是最可靠的方式:
-
charset必须写在 DSN 中,且值为UTF-8或GB18030(注意大小写和连字符:UTF-8✅,utf8❌) - DSN 格式为:
dm:server=127.0.0.1;port=5236;database=TEST;charset=UTF-8; - PHP 实例中不要调用
$pdo->exec("SET NAMES ..."),该语句在 DM 中无效 - 确保达梦服务端已启用对应字符集支持(
SELECT * FROM V$CONFIG WHERE PARA_NAME='CHARSET';应返回UTF-8或GB18030)
用 pdo_odbc 连接时需配置 odbc.ini 和 odbcinst.ini
ODBC 方式下,charset 不能靠 DSN 传递,必须通过 ODBC 驱动配置落地:
- 编辑
/etc/odbc.ini,在对应数据源(DSN)段下添加:CharacterSet=UTF-8 - 确认
Driver指向的是达梦 ODBC 驱动(如/opt/dm8/bin/libdodbc.so),不是系统默认驱动 - PHP 中 DSN 写成:
odbc:DRIVER={DM8 ODBC};SERVER=127.0.0.1;PORT=5236;UID=SYSDBA;PWD=xxx;DATABASE=TEST;(不带 charset) - 测试是否生效:执行
SELECT N'测试' FROM DUAL;,若返回正常中文,则字符集已通
PHP 文件编码与数据库字段类型要匹配
即使连接层设对了,PHP 脚本自身编码和表字段定义不一致也会导致隐性失败:
立即学习“PHP免费学习笔记(深入)”;
- PHP 源文件保存为
UTF-8 without BOM,并在 HTML 输出头加header('Content-Type: text/html; charset=utf-8'); - 达梦建表时,中文字段务必用
CHAR/VARCHAR+UTF-8字符集(例如:name VARCHAR(50) CHARSET UTF-8),不能只依赖库级默认 - 避免用
TEXT类型存中文——DM 的TEXT在某些版本中不继承连接字符集,易出乱码 - 插入前可用
mb_detect_encoding($str)检查 PHP 字符串实际编码,防止前端提交 GBK 编码却按 UTF-8 发送
达梦的字符集生效是“连接参数 + 服务端配置 + 表定义”三层叠加的结果,少一层都可能表面正常、实则埋雷。尤其要注意 charset=UTF-8 中的短横线和大小写,错一个字符就等于没设。











