使用json_encode()将php数据转换为json;2. 中文需加JSON_UNESCAPED_UNICODE避免Unicode编码;3. 支持数组、对象、布尔等类型;4. 输出前设置Content-Type: application/json;5. 用json_last_error()处理编码错误。

在php开发中,将数据转换为JSON格式是API接口开发中最常见的操作之一。无论是返回用户信息、处理前后端交互,还是对接第三方服务,JSON都因其轻量、易读和跨语言支持而成为首选的数据交换格式。
使用json_encode()函数转换PHP数据
PHP内置的 json_encode() 函数可以将PHP数组或对象转换为标准的JSON字符串。这是实现数据输出的核心方法。
例如,将一个关联数组转换为JSON:
$data = [ 'name' => '张三', 'age' => 28, 'city' => '北京' ]; echo json_encode($data); // 输出: {"name":"u5f20u4e09","age":28,"city":"u5317u4eac"}
注意:中文默认会被编码为Unicode(如u5f20),如果希望保留原始中文字符,可添加参数 JSON_UNESCAPED_UNICODE。
立即学习“PHP免费学习笔记(深入)”;
处理不同类型的数据结构
json_encode() 能处理多种PHP数据类型,包括数组、对象、数字、字符串、布尔值和NULL。
- 索引数组会转为json数组
- 关联数组会转为JSON对象
- PHP对象默认转为JSON对象(仅公开属性)
- 布尔值true/false转为JSON中的true/false
示例:
$arr = [1, 2, true, null]; echo json_encode($arr); // 输出: [1,2,true,null]
设置正确的http响应头
在API接口中输出JSON时,必须设置Content-Type为application/json,以便客户端正确解析。
使用 header() 函数设置响应头:
header('Content-Type: application/json; charset=utf-8'); $data = ['status' => 'success', 'message' => '请求成功']; echo json_encode($data, JSON_UNESCAPED_UNICODE);
这样前端javaScript或其他客户端就能正确识别返回的是JSON数据。
错误处理与调试技巧
json_encode() 在遇到无法编码的数据时会返回false,比如存在资源类型或循环引用的对象。因此建议进行结果判断。
可通过 json_last_error() 检查编码是否出错:
$json = json_encode($data); if ($json === false) { echo json_encode(['error' => '数据编码失败']); } else { echo $json; }
常见错误包括:字符串包含非法字符、数据嵌套过深、不支持的数据类型等。
基本上就这些。只要掌握 json_encode() 的基本用法、设置正确的响应头,并做好异常处理,就能稳定地在PHP中输出JSON数据,为API接口开发打下基础。


