PHP输出JSON数组的两种方法详解

本文深入解析了PHP输出JSON数组的两种核心方法：一是直接使用json_encode()处理合法关联或索引数组，并强调UTF-8编码、响应头设置及中文不转义（JSON_UNESCAPED_UNICODE）等关键细节；二是借助JSON_FORCE_OBJECT标志强制将任意数组（包括空数组或数字索引数组）统一编码为JSON对象，满足特定接口契约需求；全文贯穿实战要点——从数据预处理、错误排查（json_last_error）、乱码防治到常见陷阱规避，助你稳定、可靠地构建高质量Web API。

PHP 输出 JSON 数组的基本前提：确保数据结构合法

PHP 输出 JSON 数组前，必须确认你手里的数据是真正的数组（is_array() 返回 true），且不含无法 JSON 编码的值（如资源句柄、闭包、循环引用对象）。常见错误是直接对 mysqli_result 或 PDOStatement 对象调用 json_encode()，结果得到空字符串或 null。正确做法是先用 fetch_all()、fetchAll() 等方法转成普通数组。

用 json_encode() 直接输出关联/索引数组

这是最常用、最直接的方式，适用于大多数 Web API 场景。注意默认输出不带换行缩进，适合生产环境；调试时可加 JSON_PRETTY_PRINT 标志。

• json_encode($arr) 会自动识别 PHP 关联数组为 JSON 对象（{}），索引数组为 JSON 数组（[]）
• 中文乱码？确保 PHP 文件本身是 UTF-8 编码，并在输出前加 header('Content-Type: application/json; charset=utf-8');
• 遇到 null 输出？检查数组里是否有 NaN、INF 或不可序列化的对象属性
• 示例：

  $data = ['name' => '张三', 'scores' => [85, 92, 78]];
  header('Content-Type: application/json; charset=utf-8');
  echo json_encode($data, JSON_UNESCAPED_UNICODE);

  其中 JSON_UNESCAPED_UNICODE 防止中文被转成 \uXXXX

用 json_encode() + JSON_FORCE_OBJECT 强制输出为对象

当后端要求返回固定结构（比如总是 {} 而非 []），哪怕 PHP 数据是空数组或纯数字索引数组，就得用这个标志。否则空数组 [] 会被编码成 []，而前端可能期望 {}。

• 空数组 [] 加 JSON_FORCE_OBJECT → {}
• 数字索引数组 [1,2,3] 加该标志 → {"0":1,"1":2,"2":3}（键变成字符串）
• 和 JSON_UNESCAPED_UNICODE 可同时使用，但不能和 JSON_NUMERIC_CHECK 冲突（后者会把数字字符串转成数字）
• 示例：

  $list = [];
  echo json_encode($list, JSON_FORCE_OBJECT | JSON_UNESCAPED_UNICODE); // 输出 {}

别忘了设置响应头与错误处理

只输出 JSON 字符串却不设 Content-Type，浏览器或客户端可能按 HTML 解析，导致解析失败；没处理编码错误则可能静默输出空内容。

• 必须加 header('Content-Type: application/json; charset=utf-8');，尤其在 CLI 模式下不会自动发送，但 Web 服务器需要它
• 检查 json_last_error() 和 json_last_error_msg()，比如遇到 JSON_ERROR_UTF8 说明输入含非法 UTF-8 字节（常见于从 GBK 数据库读出未转码的字段）
• 不要在 json_encode() 前有 echo、var_dump() 或空白字符，否则 JSON 前混入 HTML 导致解析失败
• 若需兼容老版本 PHP（JSON_PARTIAL_OUTPUT_ON_ERROR 这类新标志

实际项目中最容易被忽略的是数据库字段编码和 JSON 输出前的空白输出——哪怕一行 echo ''; 或文件末尾多一个空格，都会让整个 JSON 变成无效格式。

理论要掌握，实操不能落！以上关于《PHP输出JSON数组的两种方法详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！