优秀的编程知识分享平台

网站首页 > 技术文章 正文

web后端正确的返回JSON(后端向前端怎么返回 json 格式的数据呢?)

nanyue 2024-11-11 12:26:58 技术文章 1 ℃

在web开发中,前端和后端发生数据交换传输现在最常见的形式就是异步ajax交互,一般返回给js都是json,如何才是正确的返回呢?

  • 前端代码想要获取JSON数据代码如下:

    $.get('/user-info.php', function(userInfo){

    alert(userInfo);

    alert(userInfo.name);

    });

  • 然后如果后端的user-info.php是这样的代码:

    $userInfo = [

    'id' => 1,

    'name' => 'Jay'

    ];

    echo json_encode($userInfo);

  • 那么前端第一句alert出来的将会是一个JSON字符串,第2个alert将会显示undefined

  • 原因就是回调函数里的userInfo根本不是一个object,而是一个字符串,所以alert后就是原样字符串显示了,再alert(userInfo.name);的话,由于字符串没有定义name属性,所以得到的是一个undefined的结果值

  • 为什么userInfo不是一个带有id和name属性的对象?因为PHP没有发送http响应头声明响应的内容是json

  • 其实PHP代码在echo之前补充这么一句就可以了:

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

  • 首先在没有这句代码的时候,浏览器抓到的网络请求显示响应头是这样的:

  • 注意到Content-type部分是text/html;charset=utf-8了吗?

  • 而当PHP执行header('Content-type:application/json;charset=utf-8');的时候,就变成了application/json;charset=utf-8

  • 这就是HTTP报文响应内容的格式声明,专业术语叫MIME类型

  • 如果服务端说响应的格式是text/html,那前端当然认为这并不是JSON,所以当成HTML了,HTML其实就是一堆字符串嘛

  • 所以在没有发送json类型通知时,以下两句话对于前端来说都是一样的:

echo '{"id":1}';

//或者

echo '<div>html内容。。。<div>';

  • 有人说可是上面那句echo输出的是一个JSON字符串啊,不应该识别为JSON吗?

  • 那假设jQuery是你写的,你怎么判断第1个字符串是JSON字符串?这可是要费好多功夫的,你总不可能这么写:

    var content = xmlHttpRequest.responseText;

    if(content.substr(0, 1) == '{'){

    //是json

}

  • 不然的话那后端返回{"id"这样只有半截的内容你也认为是JSON啦?

  • 其实人家判断一个数据是不是JSON,是靠HTTP响应的MIME类型来判断的,这才是标准的做法,也是HTTP协议的内容

  • 其实如果PHP不发送header声明MIME类型,只要将前端代码换成这样也能正常得到JSON:

    $.ajax({

    url : '/user-info.php',

    dataType : 'json',

    success : function(userInfo){

    alert(userInfo);

    alert(userInfo.name);

    }

});

从jQuery的源代码的ajaxConvert函数部分可以得知,当使用了$.ajax方法后,与$.get和$.post不同的是它这里声明了一个dataType的属性为json

  • 简单地说jQuery就是按照json的逻辑来解析服务端响应的内容,才不管你服务端的MIME类型是什么

  • 但这只是前端的考量,其实首先服务端的做法就不标准,既对外声明接口输出的是JSON数据,却又没声明对应的MIME类型

  • 作为追求优秀的人,我们应该按照对应的类型补充对应的MIME类型报头输出才对,输出JSON的接口总该执行一下

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

最近发表
标签列表