PHP 将空数组统一 json 序列化为 [] 的弊端

在 PHP 中表示空的map或空数组都是以空数组形式，在转化为json数据时，会将空数组统一 json 序列化成 ​​[]​​，这样就存在一个类型问题。

以前我们在与前端交互时一般是与弱类型语言js交互，对于空数组转成 ​​{}​​ 还是 ​​[]​​ 区别不大。

但随着APP的流行，PHP很多时候不是跟浏览器端的JS交互，而是跟Java和ObjC这样的静态类型语言交互，返回值的类型定义，就很重要了，举个例子

$ret1 = [ 
    'choices' => ['鱼香肉丝', '宫保鸡丁'],
    'answers' => [
        '张三' => 0,
        '李四' => 1,
        '赵云' => 0,
    ],  
];

$ret2 = [ 
    'choices' => [], 
    'answers' => [], 
];

echo json_encode($ret1) . "\n";
echo json_encode($ret2) . "\n";

输出

{"choices":["\u9c7c\u9999\u8089\u4e1d","\u5bab\u4fdd\u9e21\u4e01"],"answers":{"\u5f20\u4e09":0,"\u674e\u56db":1,"\u8d75\u4e91":0}}

{"choices":[],"answers":[]}

客户端在定义这个model的时候，可能是这样定义的

class ResultDTO {
    lateinit var choices: List<String>
    lateinit var answers: Map<String, Int>
}

当返回ret1的时候，一切顺风顺水，皆大欢喜。如果返回ret2呢，客户端抗议了

com.fasterxml.jackson.databind.JsonMappingException: Can not deserialize instance of java.util.LinkedHashMap out of START_ARRAY token

原因是什么呢？PHP的json_encode面对一个空的array的时候，它很为难，它不知道应该当它是list还是map，所以它只能一刀切，认为它就是list，于是客户端就不高兴了。解决办法不是没有，依然是强制转换。

解决方法一：[推荐]

$arr = [
     'choices' => [],
    'answers' => new \ArrayObject([])
];

$jsonRet = json_encode($arr);

print_r($jsonRet);

使用 ArrayObject 还可以像数组一样操作数据，方便很多

解决方法二：

$ret2 = [
    'choices' => [],
    'answers' => (object) [],
];

但是这样就带来一个问题，如果answers不是写死的，而是某个API的返回值，你并不确定它是不是会返回空的，它也没有义务帮你cast成object，因为JSON序列化是跟前端交互的事情，不应该放到后端service层面解决。那么你只能自己动手了，手动把返回值中可能出现空map的地方，全部强制转换一遍。

PHP的关联数组的确很强大，算法设计的也不错，性能也很好，但是它不是没有代价的，上面的例子算是其中一个。如果PHP也像其它语言一样，区分map和list，可能会省事一些，毕竟区分{}和[]，对程序员来说并不会增加很多学习成本。