PHP/MySQL编码混乱：UTF-8/ISO-8859-1统一处理方案咨询

一、服务器与PHP全局编码统一 #

• 替换Apache/Nginx的PHP配置：将php_value default_charset ISO-8859-1修改为php_value default_charset UTF-8，确保所有PHP页面默认输出UTF-8编码。
• 调整php.ini核心配置：
  • 设置mbstring.internal_encoding = UTF-8
  • 设置mbstring.http_input = UTF-8
  • 设置mbstring.http_output = UTF-8
• 页面meta标签统一：所有页面的<meta http-equiv="Content-Type"统一设置为content="text/html; charset=UTF-8"，或者直接移除（依赖PHP全局输出头即可），避免编码声明冲突。

二、MySQL字符集全链路升级为utf8mb4 #

utf8mb4是MySQL对UTF-8的完整支持，可兼容表情符号，步骤如下：

1. 备份数据库：先导出全量数据，避免迁移过程中数据丢失。
2. 修改MySQL配置文件（my.cnf/my.ini）：

   [mysqld]
   character-set-server = utf8mb4
   collation-server = utf8mb4_unicode_ci
   [client]
   default-character-set = utf8mb4
   

   重启MySQL服务生效。
3. 修改数据库、表、字段字符集：
   • 修改数据库：ALTER DATABASE 你的数据库名 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   • 修改表：ALTER TABLE 表名 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
     注：如果部分字段有特殊字符集设置，需单独调整字段的CHARSET属性
4. PHP数据库连接层编码设置：
   • PDO连接：在DSN中添加charset=utf8mb4，例如：

     $pdo = new PDO('mysql:host=localhost;dbname=你的数据库;charset=utf8mb4', '用户名', '密码');
     

   • MySQLi连接：连接成功后执行$mysqli->set_charset('utf8mb4');

三、代码层编码转换逻辑清理 #

• 移除冗余编码转换函数：删掉所有utf8_encode、mb_convert_encoding（除非有明确的跨编码交互场景，比如对接外部非UTF-8接口），避免重复转换导致乱码。
• 统一使用多字节字符串函数：替换strlen为mb_strlen、substr为mb_substr，确保中文、表情等多字节字符处理正确。
• 调整json_encode参数：输出JSON时添加JSON_UNESCAPED_UNICODE参数，保留原生Unicode字符（含表情）：

  echo json_encode($data, JSON_UNESCAPED_UNICODE);
  

四、移动端REST API兼容处理 #

• 统一API请求/响应头：所有API接口的响应头设置Content-Type: application/json; charset=utf-8，确保客户端按UTF-8解析数据。
• 处理请求参数：确保PHP接收POST/GET参数时为UTF-8编码，依赖之前设置的mbstring.http_input = UTF-8即可，无需额外转换；若接收原始JSON请求体，直接用file_get_contents('php://input')读取后json_decode，默认支持UTF-8。

五、验证环节 #

• 页面验证：查看浏览器开发者工具的响应头，确认Content-Type为UTF-8，页面内容无乱码。
• 数据库验证：插入包含表情符号的记录，查询后能正常显示，PHP读取输出也无异常。
• API验证：移动端发送带表情的请求，后端存储后返回，验证表情显示正常，无字段为空的情况。

内容的提问来源于stack exchange，提问作者shenn