php如何返回小程序所需json_php输出小程序兼容格式【教程】

7次阅读

php返回微信小程序jsON必须是无bom、UTF-8编码的标准纯数据,需禁用display_errors、清除输出缓冲、声明Content-Type头,并使用json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)确保中文可读且无多余转义。

php如何返回小程序所需json_php输出小程序兼容格式【教程】

PHP 返回给微信小程序的 JSON 必须是标准、无 BOM、UTF-8 编码的纯数据,且不能有额外输出(如空格、警告、Notice)。否则小程序 wx.request 会触发 errCode: -1 或解析失败。

确保 PHP 输出纯 JSON 且无干扰内容

常见错误:开启 display_errors、文件末尾多空行、echo 前有空格、引入了带输出的配置文件。

  • 开头加 ob_clean();ob_end_clean(); 清除已缓存的输出(临时兜底,但应优先修复源头)
  • header('Content-Type: application/json; charset=utf-8'); 显式声明类型
  • 避免任何 print_r()var_dump()echojson_encode() 前执行
  • 检查所有 include/require 的文件——尤其是 config.php,是否含 BOM 或换行

使用 json_encode() 的关键参数组合

小程序不支持 GBK、不识别 uXXXX 以外的 Unicode 转义,且对 NULL 值敏感。默认 json_encode() 可能返回中文乱码或含 html 实体。

  • 必须加 JSON_UNESCAPED_UNICODE:否则中文变成 u4f60u597d,虽合法但可读性差,调试困难
  • 建议加 JSON_UNESCAPED_SLASHES:避免 URL 字段中 https:// 这种转义
  • 若数据含 null,确认小程序端能正确处理(部分旧版基础库会跳过 null 字段)
  • 示例:echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

验证输出是否真正干净

别只看浏览器里“看起来像 JSON”,要用工具验证原始响应流。

立即学习PHP免费学习笔记(深入)”;

  • chrome DevTools 的 Network → 点击请求 → Response 标签页,右键 “Save response as…” 保存为 .txt,用十六进制编辑器查是否有 0xEF 0xBB 0xBF(BOM)
  • curl 命令验证:curl -i http://your-api.com/api.php,检查响应头是否含 Content-Type: application/json,且 body 开头就是 {[
  • 如果返回前有 Warning(如 undefined index),即使设置了 error_reporting(0),也需关掉 display_errors(php.ini 中设 display_errors = Off 或运行时用 ini_set('display_errors', '0');

最常被忽略的是 include 文件的编码和结尾换行——哪怕 config.php 最后多一个空行,PHP 都会把它当作响应体的一部分输出,导致 JSON 解析失败。动手前先用 file -i config.php 查编码,再用 xxd config.php | tail 看末尾字节

text=ZqhQzanResources