PHP数组与JSON结构对比分析

PHP数组与JSON虽常被混用，实则本质迥异：前者是灵活强大的内存数据结构，支持全类型键值与复杂PHP特性；后者是轻量、跨语言的文本交换格式，类型严格受限且语义明确。二者转换看似简单，却暗藏诸多陷阱——从中文编码乱码、浮点精度丢失、资源/闭包不可序列化，到索引数组误转为对象、私有属性静默忽略等。掌握这些差异与坑点，才能在API开发、前后端协作和配置管理中安全高效地选择和使用它们，避免“看似正常却悄然出错”的生产隐患。

PHP 数组和 JSON 都能表示键值对或有序列表，但本质不同：PHP 数组是运行时内存中的数据结构，JSON 是一种轻量级、语言无关的文本格式。两者可相互转换，但语义、类型支持和使用场景有明显差异。

数据类型支持不同

PHP 数组支持多种类型作为键（如整数、字符串，甚至对象在特定条件下），值可以是任意 PHP 类型（包括 resource、callable、对象、null 等）。JSON 仅支持有限的原生类型：字符串、数字（不区分 int/float）、布尔值、null、数组（即 JSON 中的“array”，对应 PHP 索引数组或关联数组）和对象（即 JSON 中的“object”，对应 PHP 关联数组）。

• PHP 中的 资源（resource）、函数、资源句柄、闭包 无法转成 JSON，json_encode() 会报错或静默跳过
• PHP 的浮点数若为 NaN 或 INF，json_encode() 默认返回 null（PHP 7.0+ 可通过 JSON_PARTIAL_OUTPUT_ON_ERROR 控制）
• JSON 不支持 PHP 的“空数组”与“空对象”的语义混淆——[] 在 JSON 中恒为数组，{} 恒为对象；而 PHP 中 json_encode([]) 和 json_encode(new stdClass) 输出不同，但 json_encode($arr) 是否输出 [] 还是 {} 取决于键是否全为连续数字索引

键名与索引行为差异

PHP 数组允许混合键类型（如 [0 => 'a', 'name' => 'bob', 2 => 'c']），且整数键会自动重排索引（如 unset 后再添加可能改变顺序）。JSON 对象的键必须是字符串，且无序；JSON 数组的索引必须是连续非负整数，从 0 开始，且不可跳跃或重复。

• PHP 关联数组 ['a' => 1, 'b' => 2] → json_encode() 得 {"a":1,"b":2}（JSON 对象）
• PHP 索引数组 [1, 2, 3] → json_encode() 得 [1,2,3]（JSON 数组）
• 但 [0=>1, 2=>3]（缺索引 1）→ 实际被识别为关联数组 → 输出 {"0":1,"2":3}（JSON 对象），不是预期的数组
• 解码时：json_decode($json, true) 返回 PHP 关联数组；json_decode($json, false)（默认）返回 stdClass 对象，需用 -> 访问属性

编码与解码的常见陷阱

直接用 json_encode() / json_decode() 并不总是“无损往返”，尤其涉及字符编码、特殊值或嵌套结构时。

• 中文乱码：PHP 字符串必须是 UTF-8 编码，否则 json_encode() 可能返回 false 或空字符串；可用 mb_convert_encoding($str, 'UTF-8', 'GBK') 预处理
• 深度限制：默认递归深度为 512，嵌套过深会触发 JSON_ERROR_DEPTH；可通过 json_encode($data, 0, $depth) 调整
• 对象转数组丢失方法：PHP 对象经 json_encode() 后只保留 public 属性，private/protected 属性不可见，方法完全不参与序列化
• 浮点精度：PHP 浮点数在 JSON 中可能因 double 表示产生微小误差（如 0.1 + 0.2 !== 0.3），前端解析后也可能出现类似问题，建议敏感场景用字符串传数值

何时用数组，何时用 JSON

PHP 数组适合内部逻辑处理、函数传参、缓存存储等；JSON 适合跨系统通信（API 响应/请求）、前后端数据交换、持久化为文本配置等。

• 写 API 接口时：先组织好 PHP 数组，最后一步调用 json_encode() 输出；不要手动拼 JSON 字符串
• 接收前端 JSON 请求体时：用 file_get_contents('php://input') 读原始内容，再 json_decode($raw, true) 转为数组处理
• 存储配置到文件？用 json_encode($cfg, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) 提高可读性，比 serialize() 更通用、更安全
• 调试时别直接 echo json_encode($arr)，建议配合 header('Content-Type: application/json; charset=utf-8')，避免浏览器误解析为 HTML

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。