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

special.scws.html 7.3 KB
Постоянная ссылка История Исходник

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105 
  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>在 Xunsearch 使用 SCWS</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="-xunsearch-scws">在 Xunsearch 使用 SCWS</h1>
    21. 

  21. 

  22. <p>为了便于用户在安装完 <code>Xunsearch</code> 后可以通过服务端内置的 scws[1] 实现分词，
    23. 

  23. 而不需要另外再安装 scws 的 php 扩展。从 <code>1.3.1</code> 版本起，<code>Xunsearch</code> 
    24. 

  24. 的 PHP-SDK 中加入 <a href="../api/XSTokenizerScws.html">XSTokenizerScws</a> 类，可通过搜索服务端执行分词功能。</p>
    25. 

  25. 

  26. <h2 id="ch0">1. 用法简单说明<a name="ch0" class="anchor">?</a></h2>
    27. 

  27. 

  28. <p>这儿只做简单介绍和示范，更多详细的用法请点击阅读类参考手册 <a href="../api/XSTokenizerScws.html">XSTokenizerScws</a>。</p>
    29. 

  29. 

  30. <h4 id="-">创建分词对象</h4>
    31. 

  31. 

  32. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-var">$xs</span><span class="php-hl-code"> = </span><span class="php-hl-reserved">new</span> <span class="php-hl-identifier">XS</span><span class="php-hl-brackets">(</span><span class="php-hl-code">...</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;  </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 必须先创建一个 xs 实例，否则会抛出异常</span>
    33. 

  33. <span class="php-hl-var">$tokenizer</span><span class="php-hl-code"> = </span><span class="php-hl-reserved">new</span> <span class="php-hl-identifier">XSTokenizerScws</span><span class="php-hl-code">;   </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 直接创建实例</span></pre></div></div>
    34. 

  34. 

  35. <h3 id="-">获取分词结果</h3>
    36. 

  36. 

  37. <p>调用 <a href="../api/XSTokenizerScws.html#getResult">XSTokenizerScws::getResult</a> 对参数指定的文本字符串执行分词，
    38. 

  38. 并返回词汇数组，每个词汇包含 3 个元素，其中：</p>
    39. 

  39. 

  40. <ul>
    41. 

  41. <li><em>off</em> 表示这个词汇在源参数文本 <em>$text</em> 中的起始偏移位置</li>
    42. 

  42. <li><em>attr</em> 这个词汇的词性，使用北大标注</li>
    43. 

  43. <li><em>word</em> 分好的词条</li>
    44. 

  44. </ul>
    45. 

  45. 

  46. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-var">$text</span><span class="php-hl-code"> = </span><span class="php-hl-quotes">'</span><span class="php-hl-string">迅搜(xunsearch)是优秀的开源全文检索解决方案</span><span class="php-hl-quotes">'</span><span class="php-hl-code">;
    47. 

  47. </span><span class="php-hl-var">$words</span><span class="php-hl-code"> = </span><span class="php-hl-var">$tokenizer</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">getResult</span><span class="php-hl-brackets">(</span><span class="php-hl-var">$text</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;
    48. 

  48. </span><span class="php-hl-identifier">print_r</span><span class="php-hl-brackets">(</span><span class="php-hl-var">$words</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;</span></pre></div></div>
    49. 

  49. 

  50. <h3 id="-">提取重要词汇</h3>
    51. 

  51. 

  52. <p>调用 <a href="../api/XSToenizerScws.html#getTops">XSToenizerScws::getTops</a> 可以简单提取重要词汇，它支持三个参数，
    53. 

  53. 返回的词汇数组元素和分词结果类似，只是把 <em>off</em> 替换为 <em>times</em> 
    54. 

  54. 表示这个词在文本中出现的总次数。</p>
    55. 

  55. 

  56. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-var">$text</span><span class="php-hl-code"> = </span><span class="php-hl-quotes">'</span><span class="php-hl-string">迅搜(xunsearch)是优秀的开源全文检索解决方案</span><span class="php-hl-quotes">'</span><span class="php-hl-code">;
    57. 

  57. </span><span class="php-hl-comment">//</span><span class="php-hl-comment"> 提取前 5 个重要词，要求词性必须是 n 或v 或 vn</span>
    58. 

  58. <span class="php-hl-var">$tops</span><span class="php-hl-code"> = </span><span class="php-hl-var">$tokenizer</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">getTops</span><span class="php-hl-brackets">(</span><span class="php-hl-var">$text</span><span class="php-hl-code">, </span><span class="php-hl-number">5</span><span class="php-hl-code">, </span><span class="php-hl-quotes">'</span><span class="php-hl-string">n,v,vn</span><span class="php-hl-quotes">'</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;
    59. 

  59. </span><span class="php-hl-identifier">print_r</span><span class="php-hl-brackets">(</span><span class="php-hl-var">$tops</span><span class="php-hl-brackets">)</span><span class="php-hl-code">;</span></pre></div></div>
    60. 

  60. 

  61. <h3 id="-">判断是否包含指定词性的词汇</h3>
    62. 

  62. 

  63. <p>这项功能通过 <a href="../api/XSTokenizerScws.html#hasWord">XSTokenizerScws::hasWord</a> 完成，主要目的是用于类似黑词判断。
    64. 

  64. 您可以自制一个词典，并将黑词统一设置为一个独特的属性，比如 "@"，
    65. 

  65. 那么就可以用该功能判断一段文本是否包含黑词。</p>
    66. 

  66. 

  67. <div class="hl-code"><div class="php-hl-main"><pre><span class="php-hl-var">$text</span><span class="php-hl-code"> = </span><span class="php-hl-quotes">'</span><span class="php-hl-string">...</span><span class="php-hl-quotes">'</span><span class="php-hl-code">;
    68. 

  68. </span><span class="php-hl-reserved">if</span> <span class="php-hl-brackets">(</span><span class="php-hl-var">$tokenizer</span><span class="php-hl-code">-&gt;</span><span class="php-hl-identifier">hasWord</span><span class="php-hl-brackets">(</span><span class="php-hl-var">$text</span><span class="php-hl-code">, </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-brackets">)</span> <span class="php-hl-brackets">{</span>
    69. 

  69.     <span class="php-hl-comment">//</span><span class="php-hl-comment"> 包含词性为 '@' 的词</span>
    70. 

  70. <span class="php-hl-brackets">}</span>
    71. 

  71. <span class="php-hl-reserved">else</span> <span class="php-hl-brackets">{</span>
    72. 

  72.     <span class="php-hl-comment">//</span><span class="php-hl-comment"> 为包含词性为 '@' 的词</span>
    73. 

  73. <span class="php-hl-brackets">}</span></pre></div></div>
    74. 

  74. 

  75. <h2 id="ch1">2. 使用注意事项<a name="ch1" class="anchor">?</a></h2>
    76. 

  76. 

  77. <ul>
    78. 

  78. <li><p>这个分词类底层实现是与搜索服务端通讯完成的，因此在使用前必须先初始化一个 <a href="../api/XS.html">XS</a> 对象</p></li>
    79. 

  79. <li><p>这个分词器虽然实现了 <a href="../api/XSTokenizer.html#getTokens">XSTokenizer::getTokens</a>，但不推荐直接指定到配置文件的
    80. 

  80. tokenizer 选项中，因为这样做只会让性能更低。</p></li>
    81. 

  81. </ul>
    82. 

  82. 

  83. <div class="revision">$Id$</div>
    84. 

  84. 	<div class="clear"></div>
    85. 

  85. </div><!-- end of content -->
    86. 

  86. <div id="guideNav">
    87. 

  87. 		<div class="prev"><a href="special.synonym.html">&laquo; 同义词搜索功能</a></div>
    88. 

  88. 			<div class="clear"></div>
    89. 

  89. </div><!-- end of nav -->
    90. 

  90. 

  91. <div id="apiFooter">
    92. 

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

  93. All Rights Reserved.<br/>
    94. 

  94. </div><!-- end of footer -->
    95. 

  95. 

  96. </div><!-- end of page -->
    97. 

  97. 

  98. <div style="display:none;">
    99. 

  99. 	<img src="../api/css/info.gif" />
    100. 

  100. 	<img src="../api/css/tip.gif" />
    101. 

  101. 	<img src="../api/css/note.gif" />
    102. 

  102. </div>
    103. 

  103. 

  104. </body>
    105. 

  105. </html>
    106.