本文主要是介绍新手简单集成xunsearch到自己的PHP项目中去笔录，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
想要简单集成xunsearch到自己的PHP项目中去，不难，但是官网的文档没有一个新手入门的demo，官网的demo反正我看不懂，于是我就写了踩坑完就想写这篇文章，记录下来
步骤开始：
1.首先要了解搜索的简单以原理：①安装xunsearch运行，我是在linux系统用命令行安装的，运行下面指令下载、解压安装包
wget http://www.xunsearch.com/download/xunsearch-full-latest.tar.bz2
tar -xjf xunsearch-full-latest.tar.bz2
⑴执行安装脚本，根据提示进行操作，主要是输入 xunsearch 软件包的安装目录，强烈建议单独 规划一个目录，而不是混到别的软件目录中。
cd xunsearch-full-1.3.0/
sh setup.sh
第一次安装的话，过程可能会稍显漫长，请不必着急，您大可泡杯茶一边喝一边等待即可。
⑵待命令运行结束后，如果没有出错中断，则表示顺利安装完成，然后就可以启动/重新启动 xunsearch 的后台服务，下面命令中的 $prefix 请务必替换为您的安装目录，而不是照抄。
cd $prefix ; bin/xs-ctl.sh restart
官网还叫加入开机启动，我的是云服务器，就懒得添加先，几乎不停机的。
②安装好之后按照官网的可以使用默认安装的sdk进行项目部署，也可以自己拷贝到自己的项目中去，仁者见仁智者见智了。
③重点在这里了，前面一切都准备好了，接着就是在自己的PHP代码中引入XS.php文件就能使用搜索引擎了，但是问题来了，我用的是tp5框架做的系统，官网提供的代码是：
require_once '/vendor/xunsearch/sdk/php/lib/XS.php';
我死活引入不成功，提示文件XS.php不存在；也就是没引入成功，我文件路径没错的，也存在文件，头大了，连忙百度起来，终于发现了问题所在，
require_once ‘./…/vendor/xunsearch/sdk/php/lib/XS.php’;tp框架是以index.php所在目录为根目录的，tp5是在public下的，因此要用"./…/"目录指向
以上引入没问题了。
2.项目代码集成开始，首先创建一个XS对象
(1)下面碰到个坑，对我来说是个坑，因为我一开始照着官网$this->xs = new XS(‘dev_blog’);new一个对象死活不成功，提示class xxx not found ；头发渐渐变少~~
又是一番百度，解决方法如下：
$this->xs = new \XS('dev_blog');
这个不知道是不是只有tp框架会这样，其他框架我不懂有没有这个问题了。
(2)有了搜索对象，官网的就直接执行搜索操作了，其实官网的文档是不按照流程走的，所以我就以为能用了，
$search = $this->xs->search;
$query = $keyword;
$search->setQuery($query)->setLimit(15);
$docs = $search->search();
输出都是array(0);
后来想想有哪里不对劲啊，数据都没有搜索个毛，是自己蠢了，官网的文档也是，百度出来一堆人说文档太简单了（简直啥都没说）；于是就去搜索添加数据的资料，文档确实有这个操作，但是没有说搜索前要先导入数据这个步骤，也许是我自己蠢。
foreach ($list as $key => $value) {$doc->setFields($list[$key]);$this->xs->index->update($doc);}$this->xs->index->endRebuild();$this->xs->index->flushIndex();
将上面代码写在（2）中的前面就可以了，好了终于可以搜索出来东西了
中间还碰到了数据重复问题，如我代码注释那里说的，使用add()没有唯一性限制的，重复数据也会添加到搜索数据里面的，我就用update就不会出现重复了，官网划重点：
Note: 如果索引数据库中已存在主键值相同的文档，并不会有冲突提示，文档仍会 添加成功并且不会有任何冲突提醒。所以除非您明确知道此为新文档，否则建议使用 更新文档。
此外，如果您自行扩展了 XSDocument，请使用您自定定义的文档类创建对象
更新、修改文档
在 Xunsearch PHP-SDK 中，更新、修改文档和添加文档的做法非常的类似， 只不过调用的是 XSIndex::update，并且在内部处理上有所区别。
如果索引数据库中已存在主键值相同的文档，那么相当于先删除原有的文档，再用当前文档替换它。 如果未存在主键值相同的文档，则效果和添加文档完全一致。
Info: 有人可能会想，既然如此为什么还要有 XSIndex::add 呢，因为添加文档少了一个判断 过程，具有更高一些的效率。因此，如果您在使用 API 时能明确知道当前文档是新增的，那么 还是建议使用 add 这个 API。
示范代码如下：
$data = array('pid' => 234, 'subject' => '测试文档的标题','message' => '测试文档的内容部分','chrono' => time()
);$doc = new XSDocument;
$doc->setFields($data);$this->xs->index->update($doc);
-----------------------------分割线---------------------------------------
好了，我是新手，被折腾了好久才解决，如有人碰到同样问题就应该有所帮助
这篇关于新手简单集成xunsearch到自己的PHP项目中去笔录的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
