PHP连接达梦数据库字符集配置详解

本篇文章向大家介绍《PHP连接达梦数据库字符集设置方法》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

达梦数据库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 源文件保存为 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 中的短横线和大小写，错一个字符就等于没设。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。