文档说明

体验 DEMO 项目

为了让您对 xunsearch 有一个初步的印象和了解,我们在这个章节,借助辅助工具 带您体验一下搜索和索引的操作。这里可能有很多内容您尚不熟悉,请不必感到惶恐, 只要跟着说明完成操作即可,后面还有大量章节对各项进行深入讲解。

Note: 这些例子中的命令、代码均假定为默认的 UTF-8 环境,如果您使用的是 GBK 编码环境,请在运行所有 php 脚本时加入 -c gbk 参数。

1. 查看项目配置文件

每一个 xunsearch 搜索项目都有一个独立的 INI 配置文件。DEMO 项目的配置文件 位于 $prefix/sdk/php/app/demo.ini 使用以下指令便可直接查看配置文件内容。

cat $prefix/sdk/php/app/demo.ini

没错,配置文件很简单、清晰,它默认连接本地的 8383、8384 端口并使用 UTF-8 编码,包含四个字段:pid,subject,message,chrono 。

2. 填充索引数据

出于测试方便,我们采用 csv 格式来写入索引数据,请先按以下方式操:

cd $prefix/sdk/php
util/Indexer.php --source=csv --clean demo

然后脚本会给出如下提示:

初始化数据源 ... csv
WARNING: input file not specified, read data from <STDIN>
开始批量导入数据 ...

然后我们测试输入下面三条数据,最后一条数据打完后必须敲入回车,然后按 Ctrl-D 结束操作。

Note: 在 Windows 的命令行下运行请使用 Ctrl-Z 来表示结束。

1,关于 xunsearch 的 DEMO 项目测试,项目测试是一个很有意思的行为!,1314336158
2,测试第二篇,这里是第二篇文章的内容,1314336160
3,项目测试第三篇,俗话说,无三不成礼,所以就有了第三篇,1314336168

这里屏幕会提示如下信息,表示完成数据提交:

INFO: reach end of file or error occured, total lines: 3
完成索引导入:成功 3 条,失败 0 条
刷新索引提交 ...

索引数据的提交是异步行为,所以录完数据并不是立刻就能检索到(当然,这个时间差也不会太大)。 所以为稳定起见请稍等几秒再进行下一步的搜索测试。

3. 测试搜索

首先,我们体验一下正常的搜索,分别以关键词 项目测试项目测试俗话说莫须有 进行检索:

cd $prefix/sdk/php
util/Quest.php demo 项目
util/Quest.php demo 测试
util/Quest.php demo 项目测试
util/Quest.php demo 俗话说
util/Quest.php demo 莫须有

每个搜索后的关键词系统都会记录下来进行分析,并保存在日志中用于统计热门搜索、搜索建议、相关搜索等。 默认情况系统会每 2 小时进行一次更新日志,由于我们在进行测试,所以请使用以下指令进行强制刷新。

util/Indexer.php --flush-log demo

接下来我们测试一下稍微复杂一点的字段、布尔搜索功能:

util/Quest.php demo subject:测试
util/Quest.php demo pid:2
util/Quest.php demo "第三篇 OR pid:1"

最后我们再测试一下日志相关的搜索情况,其中 --suggest 是搜索建议,当用户敲入少许汉字或字母时给出 相应的关键词建议(常用于搜索输入框下拉自动提示),而 --related 表示相关搜索、--hot 表示热门搜索、 --correct 表示搜索纠错。

util/Quest.php --hot demo
util/Quest.php --related demo 项目
util/Quest.php --correct demo yunsearch
util/Quest.php --correct demo xmcs
util/Quest.php --correct demo xianmu
util/Quest.php --suggest demo x
util/Quest.php --suggest demo xm
util/Quest.php --suggest demo xia
util/Quest.php --suggest demo xiangmuc
util/Quest.php --suggest demo 项
4. 总结

现在应该对 xunsearch 所提供的功能有了初步的印象。您可能会发现在这个体验过程中并 没有涉及到一行代码,因为我们目的只是先了解和接触一下 xunsearch 搜索,所以采用 了附加提供的脚本工具来完成所有操作,关于脚本工具的详细使用请阅读后面的专题章节。

$Id$

8条评论!

#81 报告
Kinoo at 2016-08-11 14:02:48
费解

为何按照示例,结果都是 “0 条包含”???还是说就应该是这个结果????

#60 报告
zhishufei at 2015-09-04 13:03:33
demo 完全不可用 (已经解决)

util/Indexer.php --source=csv --clean demo

这个运行错误。

XSErrorException lib/XS.php(2504): stream_set_blocking() expects parameter 1 to be resource, null given(2)

0 [internal function]: xsErrorHandler(2, 'stream_set_bloc...', '/webserver/xuns...', 2504, Array)

1 lib/XS.php(2504): stream_set_blocking(NULL, true)

2 lib/XS.php(2312): XSServer->connect()

3 lib/XS.php(2297): XSServer->open('8383')

4 lib/XS.php(368): XSServer->__construct('8383', Object(XS))

5 lib/XS.php(260): XS->getIndex()

6 Indexer.php(156): XSComponent->__get('index')

7 {main}

#52 报告
passwordlost at 2015-04-21 13:10:17
最新版本 按此 操作 无法建 新csv demo测试 安装了无法体验

cd $prefix/sdk/php util/Indexer.php --source=csv --clean demo

#46 报告
yanyun at 2014-11-15 01:51:14
也同樣遇到了14樓哥們的問題

cd $prefix/sdk/php util/Indexer.php --source=csv --clean demo 出来的是这个东西 Object id #9

請問這應當怎樣解決?

#29 报告
billowliu2 at 2013-06-04 11:53:05
导入的CSV数据,保存在哪里了呢?

bin/xs-ctl.sh start就解决了

#17 报告
manulvphp at 2012-07-27 16:36:57
很有帮助

谢谢你们的无私,我所在的小公司项目决定全文搜索使用xunsearch

#14 报告
yqy19880302 at 2012-06-19 13:39:13
这个是什么情况

cd $prefix/sdk/php util/Indexer.php --source=csv --clean demo 出来的是这个东西 Object id #9

0 lib/XS.php(2105): XSServer->read(8)

1 lib/XS.php(2090): XSServer->getRespond()

2 lib/XS.php(2067): XSServer->execCommand(Array, 201)

3 lib/XS.php(2028): XSServer->setProject('demo')

4 lib/XS.php(2011): XSServer->open('8383')

5 lib/XS.php(342): XSServer->__construct('8383', Object(XS))

6 lib/XS.php(249): XS->getIndex()

7 Indexer.php(155): XSComponent->__get('index')

8 {main}

#13 报告
ghxter at 2012-06-07 22:55:49
导入的CSV数据,保存在哪里了呢?

导入的CSV数据,保存在哪里了呢?

请到论坛 登录 后刷新本页面!