[函数]SolrQuery::addFacetQuery()函数—用法及示例

函数名：SolrQuery::addFacetQuery()

适用版本：PHP Solr扩展版本 2.0.0+

函数用法： SolrQuery::addFacetQuery() 方法用于向 Solr 查询中添加一个或多个 facet query（即针对某个字段进行聚合统计的查询）。

方法签名： public SolrQuery SolrQuery::addFacetQuery ( string $facetQuery [, string $key = NULL ] )

参数说明：

• $facetQuery：要添加的 facet query 字符串，可以是一个简单的查询字符串，也可以是多个查询字符串以逗号分隔。
• $key（可选）：如果指定了该参数，则为 facet query 设置一个键名，以便在查询结果中识别和引用该 facet query，默认为 NULL。

返回值： 返回一个 SolrQuery 对象，用于链式调用其他 SolrQuery 方法。

示例代码：

// 创建 SolrQuery 对象
$query = new SolrQuery();

// 添加 facet query
$query->addFacetQuery('category:electronics', 'electronics_facet');
$query->addFacetQuery('category:clothing', 'clothing_facet');

// 设置其他查询参数
$query->setQuery('apple');
$query->setRows(10);

// 执行查询
$response = $client->query($query);

// 获取 facet query 的统计结果
$facetCounts = $response->getFacetQueryCounts();

// 遍历统计结果
foreach ($facetCounts as $key => $count) {
    echo "Facet query '$key' has $count matching documents\n";
}

在上述示例中，我们首先创建了一个 SolrQuery 对象 $query，然后使用 addFacetQuery() 方法添加了两个 facet query，分别是 category:electronics 和 category:clothing，并为它们设置了键名 electronics_facet 和 clothing_facet。接下来，我们设置了其他查询参数，比如查询关键词为 'apple'，限制返回结果的行数为 10。最后，我们执行查询并获取 facet query 的统计结果，使用 foreach 循环遍历输出每个 facet query 的匹配文档数。

注意：在使用 SolrQuery::addFacetQuery() 方法之前，需要先确保已经成功连接到 Solr 服务器，并获取了 SolrClient 对象 $client。