中文乱码的本质是:数据在一处按 A 编码写入,在另一处按 B 编码解读。所以排查方法不是猜,而是逐层确认编码是否一致。
四个环节
- 文件本身:PHP 源文件应保存为 UTF-8 无 BOM;
- 数据库存储:库、表、字段的字符集;
- 数据库连接:连接建立后设置的
charset; - 页面输出:HTTP 响应头的
Content-Type与 HTML 的 meta。
逐层检查命令
# 1. 文件编码(应显示 UTF-8,且不带 BOM)
file -i /www/wwwroot/site/index.php
# 检查是否带 BOM(前三个字节是 EF BB BF 就有)
head -c 3 index.php | xxd
# 2. 库表字符集
mysql -e "SHOW VARIABLES LIKE 'character_set%';"
mysql db -e "SHOW CREATE TABLE articlesG" | grep CHARSET
连接层最关键
很多人只改了库表字符集,却忘了连接层。PDO 的连接串必须显式指定:
<?php
$pdo = new PDO(
'mysql:host=127.0.0.1;dbname=app;charset=utf8mb4',
$user, $pass,
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
]
);
// mysqli 写法
$mysqli = new mysqli('127.0.0.1', $user, $pass, 'app');
$mysqli->set_charset('utf8mb4');
utf8mb4 而不是 utf8:MySQL 的 utf8 实际是 utf8mb3,最多三个字节,存不了 emoji 和部分生僻字。新项目一律用 utf8mb4。
输出层
<?php
header('Content-Type: text/html; charset=utf-8');
?>
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="utf-8"></head>
已经乱码的数据怎么救
如果数据在入库时就被错误转码,需要”反向还原”。常见情况是 UTF-8 被当成 latin1 存进了 utf8 字段,可以用 CONVERT(BINARY(CONVERT(col USING latin1)) USING utf8mb4) 尝试修复。操作前务必先备份表,并且先用 SELECT 验证结果,确认无误再 UPDATE。
预防建议
新项目在创建数据库时就指定 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci,连接串写死 charset,模板统一声明 meta。三处一次做对,后面就不会再遇到这个问题。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。