PHP 处理 JSON 数组或对象#
客户端在关于 JSON 数组和 JSON 对象的处理和定义方面总是令人疑惑不已。尤其是由空对象和对象数组引起的问题。本节会展示一些 Elasticsearch JSON API 常见的数据格式,还会说明如何以 PHP 的语法来表达这些数据格式。
空对象#
Elasticsearch API 在几个地方使用了空对象,这会对 PHP 造成影响。不像其它的语言,PHP 没有一个简便的符号来表示空对象,而许多开发者还不知道如何指定一个空对象。
设想在查询中增加 Highlight:
{
"query" : {
"match" : {
"content" : "quick brown fox"
}
},
"highlight" : {
"fields" : {
"content" : {}<1>
}
}
}
- <1> 这个空对象便会引起问题
问题就在于 PHP 会自动把 "content" : {}
转换成 "content" : []
,在 Elasticsearch DSL 中这样的数据格式是非法的。我们需要告诉 PHP 那个空对象就是一个空对象而非空数组。为了在查询中定义空对象,你需要这样做:
<?php
$params['body'] = array(
'query' => array(
'match' => array(
'content' => 'quick brown fox'
)
),
'highlight' => array(
'fields' => array(
'content' => new \stdClass()<1>
)
)
);
$results = $client->search($params);
- <1> 使用 PHP 的 stdClass 对象来代表空对象,现在就可以解析为正确的 JSON 数据了。
通过使用一个 stdClass 对象,我们可以强制 json_encode
解析为空对象,而不是空数组。然而,这种冗余的写法是唯一解决 PHP 空对象的方法,没有简便的方法可以表示空对象。
对象数组#
Elasticsearch DSL 的另一种常见的数据格式是对象数组。例如,假设在你的查询中增加排序:
{
"query" : {
"match" : { "content" : "quick brown fox" }
},
"sort" : [ <1>
{"time" : {"order" : "desc"}},
{"popularity" : {"order" : "desc"}}
]
}
- <1> "sort" 内包含 JSON 对象数组。
这种形式很常见,但是在 PHP 中构建就稍微有些繁琐,因为这需要嵌套数组。用 PHP 写这种冗余的结构就让人读起来有点晦涩。为了构建对象数组,你要在数组中嵌套数组:
<?php
$params['body'] = array(
'query' => array(
'match' => array(
'content' => 'quick brown fox'
)
),
'sort' => array( <1>
array('time' => array('order' => 'desc')), <2>
array('popularity' => array('order' => 'desc')) <3>
)
);
$results = $client->search($params);
- <1> 这里 encode 为
"sort" : []
- <2> 这里 encode 为
{"time" : {"order" : "desc"}}
- <3> 这里 encode 为
{"popularity" : {"order" : "desc"}}
如果你用的是 PHP5.4 及以上版本,我强烈要求你使用 []
构建数组。这会让多维数组看起来易读些:
<?php
$params['body'] = [
'query' => [
'match' => [
'content' => 'quick brown fox'
]
],
'sort' => [
['time' => ['order' => 'desc']],
['popularity' => ['order' => 'desc']]
]
];
$results = $client->search($params);
空对象数组#
偶尔你会看到 DSL 需要上述两种数据格式。score 查询便是一个很好的例子,该查询有时需要一个对象数组,而有一些对象可能是一个空的 JSON 对象。
请看如下查询:
{
"query":{
"function_score":{
"functions":[
{
"random_score":{}
}
],
"boost_mode":"replace"
}
}
}
我们用下面的 PHP 代码来构建这个查询:
<?php
$params['body'] = array(
'query' => array(
'function_score' => array(
'functions' => array( <1>
array( <2>
'random_score' => new \stdClass() <3>
)
)
)
)
);
$results = $client->search($params);
- <1> 这里 encode 为
"functions" : []
- <2> 这里 encode 为
{ "random_score": {} }
- <3> 这里 encode 为
"random_score": {}
最后更新: 2018年7月31日 20:55:11