php输出json数组需确保数据为合法数组且无不可序列化值,正确转换数据库结果集,设置utf-8响应头,使用json_encode()配合json_unescaped_unicode、json_force_object等标志,并检查json_last_error()。

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 解析,导致解析失败;没处理编码错误则可能静默输出空内容。
立即学习“PHP免费学习笔记(深入)”;
- 必须加
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 这类新标志
echo ''; 或文件末尾多一个空格,都会让整个 JSON 变成无效格式。











