PHP加编码方法，微信小程序调用接口乱码解决

PHP接口在微信小程序中返回中文乱码，核心原因在于未正确设置HTTP响应头中的`Content-Type: application/json; charset=utf-8`，导致小程序默认按ISO-8859-1解析UTF-8编码的中文字符；同时，PHP源文件若含BOM、header()调用位置错误或仅设contentType而遗漏charset参数，都会引发问号、方块或空白响应。本文直击痛点，详解从PHP端强制声明UTF-8响应头、清除BOM、规避常见误操作，到小程序侧正确配置wx.request参数的全链路解决方案，帮你一次性根治接口中文乱码问题。

PHP接口输出中文乱码的根源在哪

微信小程序调用 PHP 接口返回中文变成问号或方块，90% 是因为 PHP 脚本没明确告诉浏览器（或小程序）“我发的是 UTF-8”。PHP 默认不自动设置 Content-Type 字符集，echo 或 json_encode 输出时只管内容，不管头信息。

必须在输出前加 header('Content-Type: application/json; charset=utf-8')

这不是可选项，是强制动作。只要接口返回 JSON（小程序 wx.request 默认解析 JSON），就必须带这个头，否则微信基础库会按 ISO-8859-1 解析字节流，UTF-8 中文直接崩坏。

常见错误写法：

• 把 header() 写在 echo 或 print 之后 → 报 Warning: Cannot modify header information
• 只写 header('Content-Type: application/json')，漏掉 ; charset=utf-8
• 用 mb_internal_encoding('UTF-8') 代替 HTTP 头 → 它只影响 mb_* 函数内部编码，不改变 HTTP 响应头

正确示例：

<?php
header('Content-Type: application/json; charset=utf-8');
$data = ['msg' => '你好，世界'];
echo json_encode($data, JSON_UNESCAPED_UNICODE);
?>

PHP 文件本身编码也得是 UTF-8 无 BOM

如果 PHP 源文件保存为 UTF-8 with BOM，BOM（Byte Order Mark）会作为不可见字符提前输出，导致 header() 调用失败，进而引发乱码或空白响应。

验证和修复方法：

• 用 VS Code / Sublime / Notepad++ 打开 PHP 文件 → 查看右下角编码显示，确认是 UTF-8，不是 UTF-8 with BOM
• 在 VS Code 中：右下角点击编码 → 选择 Save with Encoding → 选 UTF-8
• 用命令行检查：file -i your_api.php，输出中应含 charset=utf-8，不含 bom

小程序端也要注意 responseType 和解码逻辑

虽然乱码主因在 PHP 端，但小程序侧配置不当也会放大问题：

• 不要手动用 decodeURIComponent 或 unescape 处理响应体 —— json 类型响应已由微信自动 UTF-8 解码
• 确保 wx.request 的 dataType 是 'json'（默认值），而非 'text'
• 若后端返回非 JSON（比如纯文本 HTML），需显式设 responseType: 'text' 并手动处理编码，但这种情况极少用于小程序 API

真正容易被忽略的是：PHP 的 json_encode 默认会把中文转成 \uXXXX 形式，而小程序能正常还原；但如果你加了 JSON_UNESCAPED_UNICODE（推荐），就必须确保整个链路——文件编码、HTTP 头、传输过程——全是干净的 UTF-8，缺一不可。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP加编码方法，微信小程序调用接口乱码解决》文章吧，也可关注golang学习网公众号了解相关技术文章。