在php开发中，将数组转换为json格式并返回是前后端交互的常见需求，核心是通过内置函数完成数组到json的编码处理，再设置正确的响应头输出结果。
核心转换函数介绍
php提供了json_encode函数用于将数组转换为json字符串，该函数接受一个数组参数，返回对应的json格式字符串，若转换失败则返回false。如果需要将json字符串转回数组，可以使用json_decode函数，这两个函数是php处理json数据的核心工具。
基础数组转json返回示例
最简单的场景是将普通数组转换为json后返回，首先需要设置响应头告知客户端返回的是json格式数据，避免浏览器将其解析为普通文本。
<?php
// 设置响应头为json格式
header('Content-Type: application/json; charset=utf-8');
// 定义要返回的数组
$data = array(
'code' => 200,
'msg' => '请求成功',
'data' => array('id' => 1, 'name' => '测试用户')
);
// 将数组转换为json字符串并输出
echo json_encode($data);
?>
常见问题处理
中文乱码问题
如果数组中包含中文字符，直接使用json_encode可能会出现乱码或者中文字符被转换为unicode编码的情况，此时需要添加JSON_UNESCAPED_UNICODE参数，让中文正常显示。
<?php
header('Content-Type: application/json; charset=utf-8');
$data = array('name' => '张三', 'age' => 25);
// 添加JSON_UNESCAPED_UNICODE参数保留中文
echo json_encode($data, JSON_UNESCAPED_UNICODE);
?>
索引数组和关联数组的差异
索引数组转换为json后会变成数组格式，关联数组转换后会变成对象格式，如果希望索引数组也转换为对象，可以添加JSON_FORCE_OBJECT参数。
<?php
header('Content-Type: application/json; charset=utf-8');
$indexArr = array(1, 2, 3);
$assocArr = array('a' => 1, 'b' => 2);
// 索引数组转json
echo json_encode($indexArr);
echo "<br/>";
// 关联数组转json
echo json_encode($assocArr);
echo "<br/>";
// 索引数组强制转为对象
echo json_encode($indexArr, JSON_FORCE_OBJECT);
?>
转换参数汇总
以下是json_encode常用参数的说明：
| 参数常量 | 作用说明 |
|---|---|
| JSON_UNESCAPED_UNICODE | 不转义中文字符，保留原始中文显示 |
| JSON_FORCE_OBJECT | 强制将数组转换为json对象，即使是非关联数组 |
| JSON_PRETTY_PRINT | 格式化输出json字符串，带缩进方便查看 |
| JSON_UNESCAPED_SLASHES | 不转义斜杠字符，避免/被转义为/ |
注意事项
- 转换前需要确保数组中的数据都是
json_encode支持的类型，比如资源类型的数组元素会导致转换失败 - 如果数组中包含回调函数或者无法序列化的对象，需要先处理这些数据再转换
- 转换失败时可以调用
json_last_error函数获取错误码，排查转换失败的原因
phpjsonarray_to_jsonjson_encode修改时间：2026-06-20 11:39:51