PHP的json_encode()函数与JSON对象
一、问题描述
这周搬砖的时候,前端通过ajax获取后端的数据后,照例用 对象.属性
的方式取值,然而结果总是总是不能如预期般展示在页面上。
先写个 demo 还原下场景:选中一个下拉框列表选项后,会在下拉框下面展示文字。
这是下拉框的html部分:
<html> <head> <title>JSON DEMO</title> <meta charset="UTF-8"> </head> <body> <select id="device"> <option value="">终端设备</option> <option value="1">PC Web</option> <!-- <option>...</option> --> </select> <div id="tip"></div> </body> </html>
PHP代码如下:用来返回数据(接收、处理过程略)
<?php $onLines = [ 1 => 'PC Web', 2 => 'iPad HD', 5 => 'Touch' ]; echo json_encode(['data' => $onLines]);
JS代码如下:
<script type="text/javascript"> $("#device").change(function() { var selectVal = $("#device").val(); if (selectVal == '') { $("#tip").html(''); return; } # code... ajax 部分的代码见下 }); </script>
ajax 部分的代码用来接收从后端(PHP)传过来的数据,并处理。
$.ajax({ url: 'device.php', type: 'post', dateType: 'json', data: { device: selectVal }, success: function(result) { var onlineDevices = result.data; var onlineTip = '允许' + onlineDevices[selectVal] + '类型的2台设备同时在线。'; $("#tip").html(''); $("#tip").append(onlineTip); } });
使用 console.log
在控制台输出结果,如下图所示,可以看到后端返回的数据是没有问题的,
再使用 typeof
查看返回的数据类型,前端收到的数据是JSON字符串!而不是JSON对象!
success: function(result) { console.log(result); console.log(result.data); console.log(typeof result); }
二、解决方法
找到问题就好办了,只需要把 json 字符串转成 json 对象就好了,最简单的办法是 JSON.parse()
。
success: function(result) { var onlineDevices = JSON.parse(result).data; # code ... }
三、总结
1、json字符串和json对象的区别
// JSON 字符串 var str1 = '{"data":{"1":"PC Web","2":"iPad HD","5":"Touch"}}'; // JSON 对象 var str2 = {"data":{"1":"PC Web","2":"iPad HD","5":"Touch"}}; console.log(str1); console.log(typeof str1); console.log(str2); console.log(typeof str2);
可以看到json字符串和json对象的形式很像,但前者比后者多了一对引号,其内容包含在引号里了。调试台的结果如下:
2、json字符串转为json对象的方法
后端
-
设置header头中的内容类型,将 Content-Type 设置为 text/json。
header('Content-Type:text/json;charset=utf-8');
注:前端直接处理即可,不需要 JSON.parse() 处理。
但项目中用的是框架,所有的PHP文件(业务层)均没有显式设置 header,虽然在demo中此方法有效,可依然不明白为什么别的地方返回的是json对象,而这里返回的却是json字符串了。 -
强制类型转换(object) 此方法无效!
如果将一个对象转换成对象,它将不会有任何变化。如果其它任何类型的值被转换成对象,内置标准类 stdClass 的一个实例将被建立。
以上面的数组为例,强制类型转换的结果如下:
var_dump((object)['data' => $onLines]); // 结果如下: object(stdClass)#1 (1) { ["data"]=> array(3) { [1]=> string(6) "PC Web" [2]=> string(7) "iPad HD" [5]=> string(5) "Touch" } }
而json_encode((object)['data' => $onLines]);
得到的还是json字符串。
前端
- var obj = JSON.parse(str);
JSON.parse()方法,必须保证传入的是json字符串,如果是json对象会报错。 - var obj = jQuery.parseJSON(str);
parseJSON()方法是jQuery方法,仅支持标准json格式,否则会报错。
下面这些是无效的 JSON 字符串:
"{test: 1}" //test是属性名称,必须加双引号 "{'test': 1}" //test是属性名称,必须用双引号(不能用单引号) "'test'" //test是属性名称,必须用双引号(不能用单引号) "undefined" //undefined 不能表示一个 JSON 字符串; null可以 "NaN" //NaN 不能表示一个 JSON 字符串; 用Infinity直接表示无限也是不允许的
四、疑惑
查了一下PHP的 json_encode()函数,PHP手册给出的结论是成功时返回字符串。
Return Values
Returns a JSON encoded string on success or FALSE on failure.
既然json_encode()函数返回的是字符串,为什么在项目中其他地方可以直接使用 对象.属性
的方式呢?
后记 更新于2019-02-25
今天不死心,又研究了一下,还问了一个朋友,对方提醒估计大概率是编码和头的设置有问题,然后我逐行查代码,发现 ajax 部分的dataType
我写成了dateType
,一字之差~
噢,天啊,太丢人了!以后绝对不能再犯这么二的错误了!