当前位置：首页 > 问答 > 正文

php连接数据库后乱码咋整，字符集设置那些坑别踩了

连接层没设对（最常见的起点）

很多人以为在数据库里设置了字符集就万事大吉，其实连接建立的那一刻就已经开始“传话”了，如果连接时用的字符集和数据库内部的不一致,乱码从第一步就产生了。

怎么填坑： 建立连接后，立刻、马上执行一条设置字符集的SQL语句，这是最直接有效的方法。
- 对于老的 mysql_ 扩展（虽然已经废弃，但很多老项目还在用）和 mysqli 扩展，可以这样：
```
// 假设 $conn 是你的连接对象
mysqli_set_charset($conn, "utf8mb4");
```
  或者用SQL语句：
```
mysqli_query($conn, "SET NAMES 'utf8mb4'");
```
  这两句效果类似，但更推荐用 mysqli_set_charset 函数，根据PHP官方手册的说法,它能更好地避免安全风险。
- 对于PDO（推荐的方式），在创建连接的DSN（数据源名称）里就直接指定：
```
$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8mb4", $username, $password);
```
  注意，PDO的charset参数一定要写对，比如写成utf8可能还是会出问题,这个后面会讲。

第二大坑：只知道utf8，不知道utf8mb4（超级大坑）

这是很多人容易混淆的地方，MySQL里的“utf8”字符集其实是个“阉割版”，它最多只支持3个字节的字符，而真正的UTF-8编码是支持4个字节的，用来存储像emoji表情（😂）、一些生僻汉字等字符，如果你用MySQL的“utf8”去存这些4字节字符，结果就是存不进去,直接导致乱码或者数据截断。

php连接数据库后乱码咋整，字符集设置那些坑别踩了

怎么填坑： 忘掉“utf8”，统一使用“utf8mb4”，这是MySQL官方推出的、完全兼容UTF-8的字符集。
- 在你的PHP连接代码中（就是上面提到的SET NAMES或PDO的DSN参数），全部使用 utf8mb4。
- 你的数据库、甚至具体数据表的字符集和排序规则，也应该设置为 utf8mb4 相关的，utf8mb4_unicode_ci。

第三大坑：HTML页面本身没“说话”

你的PHP脚本辛辛苦苦从数据库里取出了正确的UTF-8编码的数据，但扔给浏览器的时候，浏览器并不知道该用什么“语言”来解读，浏览器可能会按照它自己猜测的编码（比如GBK）去显示,结果又乱码了。

怎么填坑： 在HTML页面的 <head> 部分，明确声明字符集。
```
<meta charset="UTF-8">
```
也可以在PHP脚本开头用header函数设置：
```
header('Content-Type: text/html; charset=utf-8');
```
这样浏览器就会乖乖地按照UTF-8来渲染页面了。

第四大坑：文件本身的编码格式

这个坑比较隐蔽，你写PHP脚本的文本编辑器（比如Notepad++, Sublime, VS Code等）也有自己的文件编码设置，如果你把文件保存成了GBK或者ANSI编码，但里面却写着中文字符，即使你上面所有设置都对了,源代码里的中文字符本身可能就是乱的。

怎么填坑： 确保你的PHP脚本文件统一保存为UTF-8 without BOM的编码格式，这是目前最通用、问题最少的格式，在你使用的编辑器中，检查保存选项，选择UTF-8无BOM。

排查乱码的“四步检查法”

当乱码发生时，别慌，按照这个顺序一步步检查,就像侦探破案一样：

检查源头（数据库）： 用数据库管理工具（如phpMyAdmin、Navicat）直接连上去，看看数据本身是不是已经乱码了，如果这里就乱了，说明问题出在写入阶段。
检查连接（PHP脚本）： 确保你的连接字符集设置（SET NAMES utf8mb4 或PDO的DSN参数）是正确的，并且是在执行查询之前设置的。
检查输出（浏览器）： 右键浏览器页面，选择“查看页面源代码”，看看源码里的中文是不是正常的，如果源码是好的，但渲染出来是乱的，99%是没设置好<meta charset="UTF-8">，如果源码本身就是乱的,问题就在PHP输出环节。
检查文件编码： 确认你的.php文件本身是用UTF-8 without BOM保存的。

总结一下核心要点：