Главная Обзор Помощь
Вход
S.H.I.E.L.D.
/
wenda-php
2
0
Ответвить 0
Файлы Задачи 0 Запросы на слияние 0 Вики
Ветка: master
Ветки Метки
wenda-php
/
protected
/
plugin
/
xsearch
/
doc
/
guide
/
search.facet.html

search.facet.html 6.9 KB
Постоянная ссылка История Исходник

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    2. 

  2. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    3. 

  3. <head>
    4. 

  4. <meta http-equiv="Content-Type" content="text/html; charset=gbk" />
    5. 

  5. <meta name="language" content="zh-cn" />
    6. 

  6. <link rel="stylesheet" type="text/css" href="../api/css/style.css" />
    7. 

  7. <link rel="stylesheet" type="text/css" href="../api/css/guide.css" />
    8. 

  8. <link rel="stylesheet" type="text/css" href="../api/css/highlight.css" />
    9. 

  9. <title>按字段值分面搜索</title>
    10. 

  10. </head>
    11. 

  11. 

  12. <body>
    13. 

  13. <div id="apiPage">
    14. 

  14. 

  15. <div id="apiHeader">
    16. 

  16. <a href="http://www.xunsearch.com" target="_blank">Xunsearch PHP-SDK</a> v1.3.2 权威指南
    17. 

  17. </div><!-- end of header -->
    18. 

  18. 

  19. <div id="content" class="markdown">
    20. 

  20. 	<div class="toc"><ol><li><a href="#ch0">适用情况</a></li><li><a href="#ch1">用法详细示范</a></li></ol></div><h1 id="-">按字段值分面搜索</h1>
    21. 

  21. 

  22. <p>分面搜索在英文中通常表述为 <code>Facets Search</code>，被检索的数据通具有多维度属性。
    23. 

  23. 例如一本书包含主题、作者、年代等，而分面搜索是指通过事物的这些属性不断筛选、
    24. 

  24. 过滤搜索结果的方法，可以将分面搜索看成搜索和浏览的结合。</p>
    25. 

  25. 

  26. <p>如果您还是不清楚它的概念，敬请参阅<a href="http://cdc.tencent.com/?p=1401">这篇文章</a>。</p>
    27. 

  27. 

  28. <h2 id="ch0">1. 适用情况<a name="ch0" class="anchor">?</a></h2>
    29. 

  29. 

  30. <p>在 <code>xunsearch</code> 中，分面搜索是按照字段的值来实现的，为了结合条件做筛选搜索，
    31. 

  31. 支持分面的字段需要进行索引，而它的分词方式最好必须是 <code>full</code> 即整值索引。</p>
    32. 

  32. 

  33. <h2 id="ch1">2. 用法详细示范<a name="ch1" class="anchor">?</a></h2>
    34. 

  34. 

  35. <p>以论坛文章搜索为例，每篇文章均属于不同版块（字段为 fid）、不同的发表年份
    36. 

  36. （字段为 year），我们需要在搜索结果中按年份、版块显示匹配的文章数。</p>
    37. 

  37. 

  38. <p>那么在构建搜索语句时使用 <a href="../api/XSSearch.html#setFacets">XSSearch::setFacets</a> 方法来指定需要分面的字段，
    39. 

  39. 该方法接受两个参数，第一参数为要分面的字段名称（多个字段请用数组作参数），
    40. 

  40. 第二参数是可选的布尔类型，true 表示需要准确统计，默认 false 则为估算。</p>
    41. 

  41. 

  42. <p>执行搜索之后再调用 <a href="../api/XSSearch.html#getFacets">XSSearch::getFacets</a> 方法可取回分面搜索结果。</p>
    43. 

  43. 

  44. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-comment">//</span><span class="php-hl-comment"> 在搜索时加入分面设置</span>
    45. 

  45. <span class="php-hl-var">$docs</span><span class="php-hl-code"> = </span><span class="php-hl-var">$search</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">setQuery</span><span class="php-hl-brackets">(</span><span class="php-hl-quotes">'</span><span class="php-hl-string">关键词</span><span class="php-hl-quotes">'</span><span class="php-hl-brackets">)</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">setFacets</span><span class="php-hl-brackets">(</span><span class="php-hl-reserved">array</span><span class="php-hl-brackets">(</span><span class="php-hl-quotes">'</span><span class="php-hl-string">fid</span><span class="php-hl-quotes">'</span><span class="php-hl-code">, </span><span class="php-hl-quotes">'</span><span class="php-hl-string">year</span><span class="php-hl-quotes">'</span><span class="php-hl-brackets">)</span><span class="php-hl-brackets">)</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">search</span><span class="php-hl-brackets">(</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;
    46. 

  46.  
    47. 

  47. </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 读取分面结果</span>
    48. 

  48. <span class="php-hl-var">$fid_counts</span><span class="php-hl-code"> = </span><span class="php-hl-var">$search</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">getFacets</span><span class="php-hl-brackets">(</span><span class="php-hl-quotes">'</span><span class="php-hl-string">fid</span><span class="php-hl-quotes">'</span><span class="php-hl-brackets">)</span><span class="php-hl-code">; </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 返回数组，以 fid 为键，匹配数量为值</span>
    49. 

  49. <span class="php-hl-var">$year_counts</span><span class="php-hl-code"> = </span><span class="php-hl-var">$search</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">getFacets</span><span class="php-hl-brackets">(</span><span class="php-hl-quotes">'</span><span class="php-hl-string">year</span><span class="php-hl-quotes">'</span><span class="php-hl-brackets">)</span><span class="php-hl-code">; </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 返回数组，以 year 为键，匹配数量为值</span>
    50. 

  50.  
    51. 

  51. <span class="php-hl-comment">//</span><span class="php-hl-comment"> 遍历 $fid_counts, $year_counts 变量即可得到各自筛选条件下的匹配数量</span>
    52. 

  52. <span class="php-hl-reserved">foreach</span> <span class="php-hl-brackets">(</span><span class="php-hl-var">$fid_counts</span> <span class="php-hl-reserved">as</span> <span class="php-hl-var">$fid</span><span class="php-hl-code"> =&gt; </span><span class="php-hl-var">$count</span><span class="php-hl-brackets">)</span>
    53. 

  53. <span class="php-hl-brackets">{</span>
    54. 

  54.     <span class="php-hl-reserved">echo</span> <span class="php-hl-quotes">&quot;</span><span class="php-hl-string">其中版块ID为 </span><span class="php-hl-var">$fid</span><span class="php-hl-string"> 的匹配数为: </span><span class="php-hl-var">$count</span><span class="php-hl-special">\n</span><span class="php-hl-quotes">&quot;</span><span class="php-hl-code">;
    55. 

  55. </span><span class="php-hl-brackets">}</span>
    56. 

  56.  
    57. 

  57. <span class="php-hl-comment">//</span><span class="php-hl-comment"> ...</span>
    58. 

  58. <span class="php-hl-comment">//</span><span class="php-hl-comment"> 通常可以循环生成新的搜索链接，在搜索链接中加入字段搜索条件即可</span>
    59. 

  59. <span class="php-hl-comment">//</span><span class="php-hl-comment"> ...</span>
    60. 

  60.  
    61. 

  61. <span class="php-hl-comment">//</span><span class="php-hl-comment"> 然后像往常一样使用 $docs 显示文档</span></pre></div></div>
    62. 

  62. 

  63. <blockquote class="tip">
    64. 

  64. <p><strong>Tip:</strong> 出于性能考虑，分面搜索返回的匹配数量默认是估算的，比实际数量可能会偏小。
    65. 

  65.   如果您确实需要得到精确数字，请将 <a href="../api/XSSearch.html#setFacets">XSSearch::setFacets</a> 的第二参数设为 true 。</p>
    66. 

  66.   
    67. 

  67.   <p>此外，分面搜索仅针对字段值较短的情况，当字段值的长度超过 <strong>255</strong> 字节时会被忽略而不参与统计。</p>
    68. 

  68.   
    69. 

  69.   <p>每次搜索最多同时支持 <strong>8</strong> 个字段进行分面搜索，分面字段必须是“字符串”类型。</p>
    70. 

  70. </blockquote>
    71. 

  71. 

  72. <div class="revision">$Id$</div>
    73. 

  73. 	<div class="clear"></div>
    74. 

  74. </div><!-- end of content -->
    75. 

  75. <div id="guideNav">
    76. 

  76. 		<div class="prev"><a href="search.fix.html">&laquo; 搜索建议和纠错</a></div>
    77. 

  77. 			<div class="next"><a href="util.check.html">RequiredCheck 运行检测 &raquo;</a></div>
    78. 

  78. 		<div class="clear"></div>
    79. 

  79. </div><!-- end of nav -->
    80. 

  80. 

  81. <div id="apiFooter">
    82. 

  82. Copyright &copy; 2008-2011 by <a href="http://www.xunsearch.com" target="_blank">杭州云圣网络科技有限公司</a><br/>
    83. 

  83. All Rights Reserved.<br/>
    84. 

  84. </div><!-- end of footer -->
    85. 

  85. 

  86. </div><!-- end of page -->
    87. 

  87. 

  88. <div style="display:none;">
    89. 

  89. 	<img src="../api/css/info.gif" />
    90. 

  90. 	<img src="../api/css/tip.gif" />
    91. 

  91. 	<img src="../api/css/note.gif" />
    92. 

  92. </div>
    93. 

  93. 

  94. </body>
    95. 

  95. </html>
    96.