S.H.I.E.L.D.
/
wenda-php


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gbk" />
<meta name="language" content="zh-cn" />
<link rel="stylesheet" type="text/css" href="../api/css/style.css" />
<link rel="stylesheet" type="text/css" href="../api/css/guide.css" />
<link rel="stylesheet" type="text/css" href="../api/css/highlight.css" />
<title>搜索测试工具</title>
</head>

<body>
<div id="apiPage">

<div id="apiHeader">
<a href="http://www.xunsearch.com" target="_blank">Xunsearch PHP-SDK</a> v1.3.2 权威指南
</div><!-- end of header -->

<div id="content" class="markdown">
	<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>

<p><code>Quest</code> 是搜索测试工具，提供了搜索相关的各项功能，非常适合用于前期测试比较和纠错。
运行脚本工具的 --help 选项可查看内置的帮助和说明，如乱码可在选项后加入 -c gbk 试试。</p>

<pre>$prefix/sdk/php/util/Quest.php --help
</pre>

<h2 id="ch0">1. 主要参数和选项<a name="ch0" class="anchor">?</a></h2>

<p>和索引工具类似，使用前必须先指定的项目名称或配置文件，所有的操作都将是作用于该项目，
主要选项如下：</p>

<ul>
<li><p><em>-p|--project &lt;name|file></em> 指定项目名称或配置文件路径，参数名可以省略不写，
如果仅指定项目名称，那么将使用 $prefix/sdk/php/app/<name>.ini 文件。</p></li>
<li><p><em>-c|--charset &lt;gbk|utf-8></em> 指定当前环境、查询语句的字符集，默认情况下，
搜索工具输出的字符集为 utf-8，并把搜索语句字符集视为项目的默认字符集。</p></li>
<li><p><em>-q|--query &lt;..query..></em> 指定要搜索的查询语句，如果语句中包含空格请用使用双引号包围起来。</p></li>
<li><p><em>--hot[=total|last|cur]</em> 用于显示指定项目的热门搜索词，此时 <em>query</em> 参数无意义。
选项值含义分别表示总搜索量、上周搜索量、本周搜索量，默认为总搜索量。</p></li>
<li><p><em>--suggest</em>、<em>--correct</em>、<em>--related</em> 是搭配 <em>query</em> 的一些功能选项。</p></li>
<li><p><em>--limit=&lt;..num..></em> 用于设置各种检索功能的返回数量最大上限，默认值均为 10 个。
对于普通搜索模式，还支持用 <em>--limit=offset,num</em> 来同时指定偏移量和上限。</p></li>
<li><p><em>-d|--db &lt;name[,name2 ...]></em> 指定要搜索的数据库名称，默认是名为 db 的库，
多个库之间用逗号分隔。</p></li>
<li><p><em>--show-query</em> 在搜索结果显示内部的 Xapian 结构的 query 语句用于调试</p></li>
<li><p><em>--synonym</em> 启用自动同义词搜索，这依赖于您的同义词库设置</p></li>
</ul>

<h2 id="ch1">2. 经典用法示例<a name="ch1" class="anchor">?</a></h2>

<p>以下是一些经典用法举例：</p>

<pre># 搜索 demo 中包含 &quot;测试&quot; 的数据
util/Quest.php demo 测试

# 搜索 demo 中包含 &quot;测试&quot; 的数据，并限制最多返回 2 条结果
util/Quest.php -p demo -q 测试 --limit=2

# 列出 demo 项目中以 &quot;x&quot; 开头的搜索建议
util/Quest.php --suggest demo x

# 在 demo 项目中修正搜索词 &quot;xm&quot;
util/Quest.php --correct demo xm

# 在 demo 中列出和 &quot;测试&quot; 相关的搜索词
util/Quest.php --related demo 测试

# 查看 demo 项目上周的 5 条最热门搜索词
util/Quest.php --hot=last --limit=5 demo
</pre>

<h2 id="ch2">3. 查看同义词表<a name="ch2" class="anchor">?</a></h2>

<p>使用 <code>--list-synonyms</code> 可以列出当前库的全部同义词记录，此选项不需要带参数。
但特殊参数值 <em>stemmed</em> 表示同时列出隐藏的词根同义词。结合选项 <code>--limit</code> 
可以设置返回的数量和偏移量，默认只返回前 100 个。例如：</p>

<pre># 默认查看当前库的前 100 个同义词记录
util/Quest.php demo --list-synonyms 

# 查看当前库第 6~10 条同义词记录
util/Quest.php demo --list-synonyms --limit 5,5

# 查看包含隐藏同义词根在内的记录
util/Quest.php demo --list-synonyms=stemmed
</pre>

<blockquote class="tip">
<p><strong>Tip:</strong> 同义词功能是 <em>1.3.0</em> 版本引入的新功能，详情参见<a href="special.synonym.html">同义词专题文档</a>。 
  添加、删除同义词的功能请参见 <a href="util.Indexer#ch8">Indexer 索引工具</a></p>
  
  <p>词根同义词是自动生成的，以大写字母 Z 开头，请勿试图进行删除</p>
</blockquote>

<div class="revision">$Id$</div>
	<div class="clear"></div>
</div><!-- end of content -->
<div id="guideNav">
		<div class="prev"><a href="util.indexer.html">&laquo; Indexer 索引管理器</a></div>
			<div class="next"><a href="util.skel.html">SearchSkel 生成搜索代码 &raquo;</a></div>
		<div class="clear"></div>
</div><!-- end of nav -->

<div id="apiFooter">
Copyright &copy; 2008-2011 by <a href="http://www.xunsearch.com" target="_blank">杭州云圣网络科技有限公司</a><br/>
All Rights Reserved.<br/>
</div><!-- end of footer -->

</div><!-- end of page -->

<div style="display:none;">
	<img src="../api/css/info.gif" />
	<img src="../api/css/tip.gif" />
	<img src="../api/css/note.gif" />
</div>

</body>
</html>