PHP项目迁移后编码乱码如何解决

本文目录导读：

1. 检查并统一文件编码
2. 设置页面输出编码
3. 配置数据库连接编码
4. 处理已存在的乱码数据
5. 配置文件编码设置
6. JSON 输出处理
7. 表单提交处理
8. 快速诊断脚本
9. 批量处理脚本
10. 常见问题速查表
11. 最佳实践建议

PHP项目迁移后出现编码乱码，通常是因为文件编码、数据库连接编码或页面输出编码三者之间不一致导致的,以下是系统的排查和解决方法：

检查并统一文件编码

首先确认所有PHP文件的编码格式：

# Linux/Mac 查看文件编码
file -i yourfile.php
# 或使用编辑器查看

解决方案：将所有文件统一为 UTF-8（无BOM）

// 使用编辑器（VS Code、Sublime等）重新保存为 UTF-8 without BOM
// 或者用代码批量转换

设置页面输出编码

在PHP文件头部添加：

<?php
// 设置HTTP头
header('Content-Type: text/html; charset=utf-8');
// 或者使用HTML meta标签
echo '<meta charset="UTF-8">';
?>

配置数据库连接编码

MySQL 连接编码设置：

<?php
// PDO 方式
$dsn = 'mysql:host=localhost;dbname=test;charset=utf8'; // 注意是 utf8 不是 utf-8
$pdo = new PDO($dsn, $user, $pass, [
    PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"
]);
// mysqli 方式
$mysqli = new mysqli($host, $user, $pass, $db);
$mysqli->set_charset('utf8mb4');
// 或者执行SQL
$mysqli->query("SET NAMES utf8mb4");
?>

检查数据库和表的编码：

-- 查看数据库编码
SHOW CREATE DATABASE your_database;
-- 查看表编码
SHOW CREATE TABLE your_table;
-- 修改数据库编码
ALTER DATABASE your_database CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 修改表编码
ALTER TABLE your_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

处理已存在的乱码数据

如果数据库已有乱码数据,需要修复：

-- 查看当前编码
SELECT HEX(content) FROM your_table LIMIT 1;
-- 如果数据是双编码（utf8->utf8的utf8），修复命令
UPDATE your_table SET content = CONVERT(CAST(CONVERT(content USING latin1) AS BINARY) USING utf8);

配置文件编码设置

php.ini 配置：

default_charset = "UTF-8"
mbstring.internal_encoding = UTF-8
mbstring.http_input = UTF-8
mbstring.http_output = UTF-8

.htaccess 设置（Apache）：

AddDefaultCharset UTF-8

JSON 输出处理

<?php
// JSON输出时指定编码
header('Content-Type: application/json; charset=utf-8');
echo json_encode($data, JSON_UNESCAPED_UNICODE);
// 或者设置 mbstring 扩展
mb_internal_encoding('UTF-8');
?>

表单提交处理

<?php
// 接收表单数据时
$_POST = array_map(function($item) {
    return mb_convert_encoding($item, 'UTF-8', 'auto');
}, $_POST);
?>

快速诊断脚本

创建一个测试文件 encoding_test.php：

<?php
header('Content-Type: text/html; charset=utf-8');
echo "文件编码测试<br>";
echo "中文测试：你好，世界！<br>";
// 数据库测试
$db = new mysqli('localhost', 'user', 'pass', 'db');
$db->set_charset('utf8mb4');
$result = $db->query("SELECT '中文测试' as test");
$row = $result->fetch_assoc();
echo "数据库编码测试：".$row['test'];
?>

批量处理脚本

修复所有乱码数据的PHP脚本示例：

<?php
// 批量修复数据库编码
$db = new mysqli($host, $user, $pass, $db);
$db->set_charset('latin1'); // 假设当前数据库实际编码是latin1
$result = $db->query("SELECT id, content FROM your_table");
while ($row = $result->fetch_assoc()) {
    $fixed = mb_convert_encoding($row['content'], 'UTF-8', 'latin1');
    $stmt = $db->prepare("UPDATE your_table SET content = ? WHERE id = ?");
    $stmt->bind_param('si', $fixed, $row['id']);
    $stmt->execute();
}
?>

常见问题速查表

现象	可能原因	解决方案
问号乱码(???)	数据库字段编码不支持该字符	改用 utf8mb4 编码
方框乱码(□□□)	缺少中文字体	安装中文字体包
完全乱码	编码不统一	统一使用 UTF-8
部分乱码	混合编码	检测并转换

最佳实践建议

1. 统一编码：所有环节使用 UTF-8
2. 备份数据：修改前先备份数据库
3. 逐步测试：每次修改后检查效果
4. 配置文件：在配置文件中设置默认编码
5. 使用框架：现代框架通常会自动处理编码问题

如果以上方法还不能解决，建议提供具体的乱码表现（截图或字符编码值）,可以更精准地诊断问题。