PHP数组转JSON格式全攻略

本文深入解析了PHP中使用json_encode()将数组转为JSON字符串时常见的五大陷阱与实战解决方案：包括因循环引用导致的“Recursion detected”错误及根治方法、中文乱码与格式化输出的参数组合技巧（如JSON_UNESCAPED_UNICODE）、返回null却无提示的隐性失败原因（如resource、XML对象、NaN等不可序列化类型）、PHP 7.4+下数字字符串键名引发的数组/对象自动转换行为，以及如何借助json_last_error()系列函数精准定位问题——帮你避开线上故障雷区，写出健壮、可维护、符合接口规范的JSON序列化代码。

PHP json_encode() 报错 “Recursion detected” 怎么办

这不是数据太大，而是数组里有循环引用——比如对象 A 的属性指向了 B，B 又反过来存了 A 的引用。json_encode() 遇到这种结构会直接报错，不抛异常，只返回 false，还带个 E_WARNING。

• 先用 var_dump(json_last_error_msg()) 确认是不是这个错误
• 检查是否用了 self、$this 或引用赋值（如 &$obj）混进了要编码的数组
• 临时方案：用 json_encode($data, JSON_PARTIAL_OUTPUT_ON_ERROR)（PHP 7.3+），它会把无法序列化的项转成 null，但别依赖它掩盖问题
• 根治办法：提前清理引用，比如用 array_map() + clone 拆开对象，或用 serialize() + 正则过滤再反解（不推荐）

中文乱码、斜杠被转义、空格太多？看这三个参数组合

json_encode() 默认把中文转 Unicode（\u4f60），加斜杠转义引号，还压缩输出。实际接口开发中往往要反着来。

• 显示中文：必须加 JSON_UNESCAPED_UNICODE，否则前端看到一堆 \u 码点
• 保留换行缩进（调试用）：加 JSON_PRETTY_PRINT，但上线环境建议关掉，体积大、解析慢
• 不转义斜杠（比如 URL 字段里的 https://）：加 JSON_UNESCAPED_SLASHES，否则变成 https:\/\/
• 常见组合：json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)

为什么 json_encode() 返回 null 却没报错？

返回 null 是最坑的情况——函数执行了，没警告，也没异常，但结果丢了。大概率是数据里混入了不能序列化的类型。

• 检查有没有 resource 类型（比如 fopen() 返回的句柄）
• 确认没有 SimpleXMLElement 对象（XML 解析结果），它不能直出 JSON
• 注意 NaN、INF、-INF 在 PHP 中会被静默转成 null
• 用 json_last_error() 判断：返回 JSON_ERROR_INF_OR_NAN 或 JSON_ERROR_UNSUPPORTED_TYPE 就对了

PHP 7.4+ 数组键名含数字字符串时，json_encode() 自动转对象？

是的。当数组键不是“连续数字索引”，又包含字符串数字（比如 ['0' => 'a', '1' => 'b']），json_encode() 会把它当成关联数组处理，最终输出为 JSON 对象而非数组。

• 这是 PHP 行为，不是 bug：只要键不是从 0 开始的纯整数序列，就视为“非顺序索引数组”
• 想强制输出 JSON 数组？先用 array_values() 重排键名，但会丢掉原始键名语义
• 如果需要保留键名且确保是对象格式，不用干预；如果调用方强依赖数组格式（如 JS Array.isArray()），就得在 PHP 层做结构适配

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP数组转JSON格式全攻略》文章吧，也可关注golang学习网公众号了解相关技术文章。