• 按字段值分面搜索

    按字段值分面搜索

    分面搜索在英文中通常表述为 Facets Search,被检索的数据通具有多维度属性。例如一本书包含主题、作者、年代等,而分面搜索是指通过事物的这些属性不断筛选、过滤搜索结果的方法,可以将分面搜索看成搜索和浏览的结合。

    如果您还是不清楚它的概念,敬请参阅这篇文章。1. 适用情况在 xunsearch 中,分面搜索是按照字段的值来实现的,为了结合条件做筛选搜索,支持分面的字段需要进行索引,而它的分词方式最好必须是 full 即整值索引。2. 用法详细示范以论坛文章搜索为例,每篇文章均属于不同版块(字段为 fid)、不同的发表年份(字段为 year),我们需要在搜索结果中按年份、版块显示匹配的文章数。

    那么在构建搜索语句时使用 XSSearch::setFacets 方法来指定需要分面的字段,该方法接受两个参数,第一参数为要分面的字段名称(多个字段请用数组作参数),第二参数是可选的布尔类型,true 表示需要准确统计,默认 false 则为估算。

    执行搜索之后再调用 XSSearch::getFacets 方法可取回分面搜索结果。

    1. // 在搜索时加入分面设置
    2. $docs = $search->setQuery('关键词')->setFacets(array('fid', 'year'))->search();
    3.  
    4. // 读取分面结果
    5. $fid_counts = $search->getFacets('fid'); // 返回数组,以 fid 为键,匹配数量为值
    6. $year_counts = $search->getFacets('year'); // 返回数组,以 year 为键,匹配数量为值
    7.  
    8. // 遍历 $fid_counts, $year_counts 变量即可得到各自筛选条件下的匹配数量
    9. foreach ($fid_counts as $fid => $count)
    10. {
    11. echo "其中版块ID为 $fid 的匹配数为: $count\n";
    12. }
    13.  
    14. // ...
    15. // 通常可以循环生成新的搜索链接,在搜索链接中加入字段搜索条件即可
    16. // ...
    17.  
    18. // 然后像往常一样使用 $docs 显示文档

    Tip: 出于性能考虑,分面搜索返回的匹配数量默认是估算的,比实际数量可能会偏小。 如果您确实需要得到精确数字,请将 XSSearch::setFacets 的第二参数设为 true 。

    此外,分面搜索仅针对字段值较短的情况,当字段值的长度超过 255 字节时会被忽略而不参与统计。

    每次搜索最多同时支持 8 个字段进行分面搜索,分面字段必须是“字符串”类型。