3分钟短文 | PHP 返回 Json 字符串，这2个关键点，你别大意了

liuian 2025-05-22 11:44 43 浏览

引言

很多时候如果手动写 PHP，不使用框架，并且是 API 接口，应该怎么返回json数据呢？离开框架还能不能写应用，这是对一个程序员基本功最好的检验。

本文就说一说在PHP中如何返回json格式的数据。

学习时间

直接上代码，很简短，我们逐行讲解：

$data = ['code' => 1, 'msg' => 'success', 'list' => array()];
header('Content-Type: application/json');
echo json_encode($data);

首先原始数据是 $data，这是一个数组，我们想要做的就是把这个数组，作为序列化的json字符串发送出去。

接着，非常关键，就是一定要设定响应的 header，格式一定是 application/json。

准备停当，最后就是发字符串刷入缓存区，并输出给客户端。其中 json_encode 就是数组的的序列化函数。

如果是英文语种的国家，当然没什么问题。可是，对于支持国际化的应用，我们还是要使用通用的 UTF-8 编码，这样的接口可以走遍世界了 :) 只需要把 header 添加编码声明：

header('Content-type:application/json;charset=utf-8');

光说不练假把式，来个有点实操性质的例子吧：

$option = $_GET['option'];

if ( $option == 1 ) {
    $data = [ 'a', 'b', 'c' ];
} else {
    $data = [ 'name' => 'God', 'age' => -1 ];
}

header('Content-type: application/json;charset=utf-8');
echo json_encode( $data );

获取输入参数，处理参数，然后声明头部信息，最后输出给客户端，一气呵成。

进阶：错误处理

代码不变，可是数据总是在变，所以不能保证不出错。比如 json_encode 函数完全可能序列化失败而返回 false。那就需要故障处理一下了：

header("Content-Type: application/json;charset=utf-8");
$json = json_encode($data);
if ($json === false) {
    $json = json_encode(["jsonError" => json_last_error_msg()]);
    if ($json === false) {
        $json = '{"jsonError":"unknown"}';
    }
    http_response_code(500);
}
echo $json;

经过故障捕捉，客户端请求后完全可以拿到故障信息，或者 500 服务器故障码。这样的API友好了许多。

写在最后

本文通过几个示例演示了PHP中如何返回json字符串，成熟的框架大多进行了很好的处理，而且捆绑在 response 响应体内。手动实现有助于我们理解程序的处理过程。

Happy coding :_)

我是 @程序员小助手，持续分享编程知识，欢迎关注。

php接收json数据

上一篇：Flutter——输入部件
下一篇：php json_decode返回null

3分钟短文 | PHP 返回 Json 字符串，这2个关键点，你别大意了

引言

学习时间

进阶：错误处理

写在最后

相关推荐

【验证码逆向专栏】vaptcha 手势验证码逆向分析

Python实现人事自动打卡，再也不会被批评

Psutil + Flask + Pyecharts + Bootstrap 开发动态可视化系统监控

一个解决支持HTML/CSS/JS网页转PDF(高质量)的终极解决方案

再见Swagger UI 国人开源了一款超好用的 API 文档生成框架，真香

网页转成pdf文件的经验分享网页转成pdf文件的经验分享怎么弄

C++ std::vector 简介

飞牛OS入门安装遇到问题，如何解决?

系统C盘清理:微信PC端文件清理，扩大C盘可用空间步骤

10款高性能NAS丨双十一必看，轻松搞定虚拟机、Docker、软路由

3分钟短文 | PHP 返回 Json 字符串，这2个关键点，你别大意了

引言

学习时间

进阶：错误处理

写在最后

相关推荐

【验证码逆向专栏】vaptcha 手势验证码逆向分析

Python实现人事自动打卡，再也不会被批评

Psutil + Flask + Pyecharts + Bootstrap 开发动态可视化系统监控

一个解决支持HTML/CSS/JS网页转PDF(高质量)的终极解决方案

再见Swagger UI 国人开源了一款超好用的 API 文档生成框架，真香

网页转成pdf文件的经验分享 网页转成pdf文件的经验分享怎么弄

C++ std::vector 简介

飞牛OS入门安装遇到问题，如何解决?

系统C盘清理:微信PC端文件清理，扩大C盘可用空间步骤

10款高性能NAS丨双十一必看，轻松搞定虚拟机、Docker、软路由

网页转成pdf文件的经验分享网页转成pdf文件的经验分享怎么弄