如何解决PHP 8.2环境下PDO连接MariaDB的编码问题_设置charset与排序规则-php教程-PHP中文网

必须在pdo dsn中显式写入charset=utf8mb4，否则即使数据库、表、列全设为utf8mb4，php仍可能以latin1通信，导致插入en dash或emoji时报incorrect string value错误。

如何解决php 8.2环境下pdo连接mariadb的编码问题_设置charset与排序规则

必须在PDO DSN中显式写入 charset=utf8mb4，否则即使数据库、表、列全设为 utf8mb4，PHP仍可能以 latin1 通信，导致连字符、表情符号等直接报 Incorrect string value 错误。

为什么只改数据库字符集还不够

很多人把数据库、表、列全设成 utf8mb4 就以为万事大吉，结果插入 –（en dash）或 ✅ 时还是失败。根本原因是：PDO连接建立时，MySQL客户端协议默认不声明编码，MariaDB服务端按全局 character_set_client（常是 latin1）解析传入字节。你发的是UTF-8字节，它却当latin1解，自然出错。

这和HeidiSQL能成功无关——它的GUI连接默认带 SET NAMES utf8mb4，而PDO不会自动帮你补。

仅执行 ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4 只改存储层，不改通信层
仅在PHP里用 mb_convert_encoding() 转字符串，解决不了PDO传输时的解码错位
mysqli_set_charset($conn, 'utf8mb4') 对PDO无效，PDO必须靠DSN或exec("SET NAMES utf8mb4")

DSN中`charset=utf8mb4`必须写对位置

DSN里 charset 参数不是可选修饰，而是强制生效的关键开关。它会触发PDO在连接后自动执行 SET NAMES utf8mb4，并设置客户端变量 character_set_client、character_set_results、character_set_connection 三者一致。

错误写法：mysql:host=localhost;dbname=test;charset=UTF8（大小写敏感，UTF8 不被识别）

正确写法：mysql:host=localhost;dbname=test;charset=utf8mb4

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

必须小写 utf8mb4，UTF8、utf8、UTF-8 均无效
不能加空格，如 charset= utf8mb4 会导致连接静默降级为 latin1
PHP 8.2+ 已废弃 PDO::MYSQL_ATTR_INIT_COMMAND 模拟 SET NAMES，应直接用 charset 参数

排序规则（collation）不需要在DSN里指定

DSN中的 charset 只管传输编码，不影响数据比较逻辑。排序规则由列定义决定，例如建表时用 username VARCHAR(20) COLLATE utf8mb4_unicode_ci，后续查询的 ORDER BY、WHERE LIKE 都按这个规则走。

如果你在 SELECT 中临时需要不同排序行为，用 COLLATE 显式指定即可，比如：

SELECT * FROM users WHERE name COLLATE utf8mb4_bin = 'admin'

强行在DSN里加 collation=utf8mb4_unicode_ci 不但无效，还会让PDO抛出 PDOException: SQLSTATE[HY000] [1049] Unknown database 类似错误——因为MariaDB不认这个参数。

`htmlspecialchars()` 和编码问题根本不是一回事

看到乱码就去套 htmlspecialchars($str, ENT_QUOTES, 'UTF-8') 是典型误操作。这个函数只转义 、<code>> 等HTML符号，**不修复编码错位**。如果PDO传过来的字符串本身已被错误解码（比如把UTF-8的 0xE2 0x80 0x93 当latin1读成三个乱码字），htmlspecialchars 处理的是那三个乱码，结果更不可控，甚至返回空字符串。