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

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

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990 
  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><li><a href="#ch2">直接获取搜索匹配数</a></li></ol></div><h1 id="-">获取搜索匹配数量</h1>
    21. 

  21. 

  22. <p>出于性能考虑，搜索结果的匹配数量均被设计为估算值，并非准确值。</p>
    23. 

  23. 

  24. <h2 id="ch0">1. 索引库内的数据总数<a name="ch0" class="anchor">?</a></h2>
    25. 

  25. 

  26. <p>这个数量是真实准确的，并非估算，获取总量有以下两种做法，至于喜欢用哪种您自己决定。</p>
    27. 

  27. 

  28. <ul>
    29. 

  29. <li>调用方法 <a href="../api/XSSearch.html#getDbTotal">XSSearch::getDbTotal</a></li>
    30. 

  30. <li>读取魔术属性 <a href="../api/XSSearch.html#dbTotal">XSSearch::dbTotal</a>，内部也是调用上述方法 </li>
    31. 

  31. </ul>
    32. 

  32. 

  33. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-var">$total</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">dbTotal</span><span class="php-hl-code">;
    34. 

  34. </span><span class="php-hl-var">$total</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">getDbTotal</span><span class="php-hl-brackets">(</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;</span></pre></div></div>
    35. 

  35. 

  36. <h2 id="ch1">2. 最近一次搜索的匹配数<a name="ch1" class="anchor">?</a></h2>
    37. 

  37. 

  38. <p>通过 <a href="../api/XSSearch.html#getLastCount">XSSearch::getLastCount</a> 或 <a href="../api/XSSearch.html#lastCount">XSSearch::lastCount</a> 可以快速获取到最近一次调用
    39. 

  39. <a href="../api/XSSearch.html#search">XSSearch::search</a> 进行搜索时得到的匹配数量。</p>
    40. 

  40. 

  41. <p>除非您对搜索结果完全不关心，否则强烈建议用这种方法获取匹配数目以减少系统开销。</p>
    42. 

  42. 

  43. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-comment">//</span><span class="php-hl-comment"> 假设曾经有一次 search 调用</span>
    44. 

  44. <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">setLimit</span><span class="php-hl-brackets">(</span><span class="php-hl-number">5</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">;
    45. 

  45.  
    46. 

  46. </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 必须在 search() 之后调用</span>
    47. 

  47. <span class="php-hl-var">$count</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">lastCount</span><span class="php-hl-code">;
    48. 

  48. </span><span class="php-hl-var">$count</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">getLastCount</span><span class="php-hl-brackets">(</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;</span></pre></div></div>
    49. 

  49. 

  50. <h2 id="ch2">3. 直接获取搜索匹配数<a name="ch2" class="anchor">?</a></h2>
    51. 

  51. 

  52. <p>通过 <a href="../api/XSSearch.html#count">XSSearch::count</a> 调用可以直接获取搜索的匹配数量，该方法和 <a href="../api/XSSearch.html#search">XSSearch::search</a> 
    53. 

  53. 类似，在调用前可以做一系列的搜索查询语句构建，也可以直接接受查询语句做参数。</p>
    54. 

  54. 

  55. <p>返回值是一个整型数字，是估算值。</p>
    56. 

  56. 

  57. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-comment">//</span><span class="php-hl-comment"> 先设置 Query 再获取数量</span>
    58. 

  58. <span class="php-hl-var">$count</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">count</span><span class="php-hl-brackets">(</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;
    59. 

  59.  
    60. 

  60. </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 直接把 Query 语句传入</span>
    61. 

  61. <span class="php-hl-var">$count</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">count</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">;</span></pre></div></div>
    62. 

  62. 

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

  64. <p><strong>Tip:</strong> 对于不带参数的 <code>count</code> 调用建议放在 <code>search</code> 之后，内部会进行优化，减少一次查询。</p>
    65. 

  65. </blockquote>
    66. 

  66. 

  67. <div class="revision">$Id$</div>
    68. 

  68. 	<div class="clear"></div>
    69. 

  69. </div><!-- end of content -->
    70. 

  70. <div id="guideNav">
    71. 

  71. 		<div class="prev"><a href="search.search.html">&laquo; 获取搜索匹配结果</a></div>
    72. 

  72. 			<div class="next"><a href="search.hot.html">获取热门搜索词 &raquo;</a></div>
    73. 

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

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

  75. 

  76. <div id="apiFooter">
    77. 

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

  78. All Rights Reserved.<br/>
    79. 

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

  80. 

  81. </div><!-- end of page -->
    82. 

  82. 

  83. <div style="display:none;">
    84. 

  84. 	<img src="../api/css/info.gif" />
    85. 

  85. 	<img src="../api/css/tip.gif" />
    86. 

  86. 	<img src="../api/css/note.gif" />
    87. 

  87. </div>
    88. 

  88. 

  89. </body>
    90. 

  90. </html>
    91.