一、Xunsearch安装:
1、官网(http://xunsearch.com)下载wget http://www.xunsearch.com/download/xunsearch-full-latest.tar.bz2
2、解压tar -jxvf xunsearch-full-1.4.11.tar.bz2
3、进入目录cd xunsearch-full-1.4.11
4、安装(无需编译配置)sh setup.sh
说明:
1、安装过程中需要指定安装目录(/usr/local/xunsearch)
2、首次安装可能需要几分钟,中间不出问题表示安装成功
5、启动测试cd /usr/local/xunsearch/bin
./xs-ctl.sh start
说明:也可以将/usr/local/xunsearch/bin 目录添加到系统环境变量中
6、添加开机启动
在 /etc/rc.local 文件最后添加下面一句话/usr/local/xunsearch/bin/xs-ctl.sh start
在/etc/profile最后一行添加环境变量:/usr/local/xunsearch/bin
说明:会启动两个服务
1、索引服务(8383):负责索引的添加、删除、修改
2、搜索服务(8384):负责提供搜索服务
二、体验demo项目
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
开始批量导入数据 ...
然后我们测试输入下面三条数据,最后一条数据打完后必须敲入回车,然后按 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 项
其它:详见手册
三、项目配置文件
基本说明:
1、项目配置是一个项目的核心灵魂,非常重要,通常保存为.ini文件,通常存储在/usr/local/xunsearch/sdk/php/app/
2、以分号开头的行表示注释,空行直接被忽略不起任何作用
3、中括号包围的每个分区均为字段配置,字段个数根据项目的实际需求设定
4、每个项目必须有且只能有一个类型为ID的主键字段,ID字段值的字母不区分大小写
常用配置:
名称:project.name = xxx
字符集:project.default_charset = UTF-8
索引服务端口:server.index = 8383
搜索服务端口:server.search = 8384
项目字段:
字段名:【字段名】
字段类型:type = xxx
字段类型:
字符型:string,适用多数情况,默认值
数值型:numeric,包含整型和浮点数,仅当字段需用以排序或区间检索时才设为该类型,否则使用string即可
日期型:date,形式为YYYYmmdd 这样固定的8字节
主键型:id,确保每条数据具备唯一值,是索引更新和删除的凭据,每个搜索项目必须有且仅有一个id字段,该字段的值不区分大小写
标题型:title,标题或名称字段,至多有一个该类型的字段
内容型:body,主内容字段,即本搜索项目中内容最长的字段,至多只有一个该类型字段,本字段不支持字段检索
四、PHP代码操作
认识对象:
XS搜索项目总对象,所有相关操作均基于此对象及子方法
XSDocument搜索结果或索引文档,包括一组字段及值,相当于SQL表中的一条记录
XSIndex索引管理,通过XS对象的index属性取得
XSSearch 搜索功能,通过XS对象的search属性取得
XSException异常类型,必须捕捉此异常以判断操作是否正确
基本使用:include '/usr/local/xunsearch/sdk/php/lib/XS.php';
try{
//创建XS对象
$xs = new XS('demo');
//获取索引对象
$index = $xs->index;
//获取搜索对象
$search = $xs->search;
$data = [
'pid'=>123,
'subject'=>'测试文档标题',
'message'=>'测试文档内容',
'chrono'=>time()
];
$doc = new XSDocument($data);
//添加索引
$index->add($doc);
//修改
$index->update($doc);
//删除,更快主键,多个传递数组
$index->del('123');
//同步索引
$index->flushIndex();
//清空索引
$index->clean();
$search->search('测试');
$search->search('测试 文档');
$search->search('测试 OR 文档');
}catch (XSException $e){
echo $e->getTTracsAsString();
}
免责声明:本文来源于,由网友提供或网络搜集,仅供个人研究、交流学习使用,不涉及商业盈利目的。如有版权问题,请联系本站管理员予以更改或删除。优知网会定期发布程序开发相关趋势文章,包括 PHP、 Linux、 Mysql 等领域,敬请关注!最后大家可以扫描下方的赞赏码支持我,感谢大家!