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


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147
							<!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><li><a href="#ch3">删除搜索词</a></li><li><a href="#ch4">添加/更新搜索词</a></li></ol></div><h1 id="-">搜索日志管理</h1>

<p><code>Logger</code> 是搜索日志管理工具，针对搜索日志关键词提供查询、删除、更新、刷新、清空等功能。</p>

<blockquote class="tip">
<p><strong>Tip:</strong> 热门搜索、相关搜索、拼音搜索、搜索纠错和建议这些功能都是基于搜索日志来实现的。
  搜索日志是后台自动分析和生成的，所以可能存在一些偏差和错误，您可借助本工具处理。</p>
</blockquote>

<p>运行脚本工具的 --help 选项可查看内置的帮助和说明，如乱码可在选项后加入 -c gbk 试试。</p>

<pre>$prefix/sdk/php/util/Logger.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>--import=&lt;..file..></em> 导入搜索日志文件，每行一个词，每行的数据中可以用&#92;t(Tab键)分开指定次数，没有次数默认为1。</p></li>
<li><p><em>--put=&lt;word1[:wdf1][,word2[:wdf2]]...></em>  添加、更新搜索日志词汇，词与次数之间用半角冒号分隔，默认为 1 次。
多个词之间用,(半角)分隔，词之间如果包含空格，请将参数用引号包围起来。</p></li>
<li><p><em>--del=&lt;word1[,word2...]></em> 删除搜索日志中的关键词记录，删除多个词汇用半角逗号分隔，若不存在则会提示相关词</p></li>
<li><p><em>--query=&lt;..word..></em> 以 word 为关键词列出相关搜索词，可用 limit 选项设置个数，默认 6 个</p></li>
<li><p><em>--hot=&lt;total|last|cur></em> 列出热门搜索词，参数依次表示总次数、上期次数、本期次数，
可用 limit 指定个数，默认 10 个。</p></li>
<li><p><em>--limit=&lt;..num..></em> 用于控制 query 和 hot 选项的返回记录数量</p></li>
<li><p><em>--flush</em>  强制提交搜索日志变动</p></li>
<li><p><em>--clean</em> 清空搜索日志全部内容</p></li>
</ul>

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

<p>以下是一些常见用法举例：</p>

<pre># 查看 demo 项目中 热门搜索词
util/Logger.php demo
util/Logger.php demo --hot=cur

# 查询 demo 项目中 &quot;word&quot; 相关搜索词汇
util/Logger.php demo word
util/Logger.php demo word --limit 5

# 把日志文件 words.txt 导入 dmeo 项目中
util/Logger.php --import=words.txt demo

# 清空 demo 项目中 全部搜索日志索引，通常在重建搜索项目或日志数据过于混乱时才需调用
util/Logger.php --clean demo
</pre>

<h2 id="ch2">3. 导入搜索日志文件<a name="ch2" class="anchor">?</a></h2>

<p>当您有大批搜索日志词汇需要一并更新时，用 <code>--put</code> 可能力不从心了，我们特别提供了
<code>--import</code> 选项用于导入搜索日志文件。</p>

<p>搜索日志文件必须是 <code>UTF-8</code> 编码，如果不是请在使用前转换好。文件格式为一行一个词，
每个词后面可以用制表符 <code>\t</code> 隔开写上搜索次数，默认则为 1 次。以半角的 <code>;</code> 和 <code>#</code> 
开头的行表示注释。以下为示范文件内容：</p>

<pre># 这行表示注释，被忽略
更新词
更新词2    123
</pre>

<p>导入的用法很简单，只要用 <code>--import</code> 指定路径即可，导入过程中会依次打印每个词的情况，
命令如下：</p>

<pre>util/Logger.php --import=/path/to/words.txt demo
</pre>

<h2 id="ch3">4. 删除搜索词<a name="ch3" class="anchor">?</a></h2>

<p>热门搜索、相关搜索通常是自动处理的，但如果你不希望出现某些词，可以用 <code>--del</code> 
选项删除这些词。选项的值表示要删除的词，多个词之间用半角的逗号分隔，如果搜索词包含空格，
请使用半角引号包围选项值。用法如下：</p>

<pre># 删除 demo 项目中 搜索日志词 word
util/Logger.php --del=word demo

# 删除 demo 项目中 搜索日志词 word 和 &quot;word1 word2&quot;
util/Logger.php --del &quot;word,word1 word2&quot; demo
</pre>

<h2 id="ch4">5. 添加/更新搜索词<a name="ch4" class="anchor">?</a></h2>

<p>您可以用 <code>--put</code> 选项快速添加、更新少量几个搜索词，常用于替换热门搜索词。
选项的值表示要更新或添加的词，词后面可以用半角的冒号连接搜索次数，若不指定默认为 1 次。
多个词之间用半角的逗号分隔，词汇中包含空格则注意采用引号包围。用法举例：</p>

<pre># 在 demo 项目中 添加搜索词 word 次数为 1
util/Logger.php --put=word demo

# 在 demo 项目中 添加搜索词 word 次数为 123，添加搜索词 &quot;word1 word2&quot; 次数为 456
util/Logger.php --put=&quot;word:123,word1 word2:456&quot; demo
</pre>

<blockquote class="note">
<p><strong>Note:</strong> 删除、更新、导入搜索词都是异步行为，也就是说执行完命令后需要等待一段时间才能生效。</p>
</blockquote>

<div class="revision">$Id$</div>
	<div class="clear"></div>
</div><!-- end of content -->
<div id="guideNav">
		<div class="prev"><a href="util.ini.html">&laquo; IniWizzard 配置文件向导</a></div>
			<div class="next"><a href="special.synonym.html">同义词搜索功能 &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>