Laravel 5.5 集成 xunsearch(迅搜)由于使用过程中坑过于太多由此记录2018-09-06

第一步:安装迅搜服务端

  wget http://www.xunsearch.com/download/xunsearch-full-latest.tar.bz2
  tar -xjf xunsearch-full-latest.tar.bz2 xunsearch
  cd xunsearch/
  sudo sh setup.sh

安装完成后,会显示一下东西可能显示的不一样:

 +==========================================+ 
 | Welcome to setup xunsearch(full)         | 
  | 欢迎使用 xunsearch (完整版) 安装程序       | 
+------------------------------------------+ 
| Follow the on-screen instructions please | 
| 请按照屏幕上的提示操作以完成安装            | 
+==========================================+ 

Please specify the installation directory 
请指定安装目录 (默认为中括号内的值) 
[/usr/local/xunsearch]: 

Confirm the installation directory 
请确认安装目录:/usr/local/xunsearch [Y/n]Y 
Checking scws ... no 
Installing scws (1.2.3) ...  
Extracting scws package ... 
Configuring scws ... 
Compiling & installing scws ... 
Checking scws dict ... no 
Extracting scws dict file ...  
Checking libuuid ... no, try to install it 
Extracting libuuid package ... 
Configuring libuuid ... 
Compiling & installing libuuid ... 
Checking xapian-core-scws ... no 
Installing xapian-core-scws (1.2.22) ...  
Extracting xapian-core-scws package ... 
Configuring xapian-core-scws ... 
Compiling & installing xapian-core-scws ... 
Checking libevent ... no 
Installing libevent (2.0.21-stable) ...  
Extracting libevent package ... 
Configuring libevent ... 
Compiling & installing libevent ... 
Extracting xunsearch package (1.4.10) ... 
Configuring xunsearch ... 
Compiling & installing xunsearch ... 
Cleaning ... done 

+=================================================+ 
| Installation completed successfully, Thanks you | 
| 安装成功,感谢选择和使用 xunsearch                | 
+-------------------------------------------------+ 
| 说明和注意事项:                                  | 
| 1. 开启/重新开启 xunsearch 服务程序,命令如下:    | 
|    /usr/local/xunsearch/bin/xs-ctl.sh restart   | 
|    强烈建议将此命令写入服务器开机脚本中             | 
|                                                 | 
| 2. 所有的索引数据将被保存在下面这个目录中:         | 
|    /usr/local/xunsearch/data                    | 
|    如需要转移到其它目录,请使用软链接。             | 
|                                                 | 
| 3. 您现在就可以在我们提供的开发包(SDK)基础上       | 
|    开发您自己的搜索了。                           | 
|    目前只支持 PHP 语言,参见下面文档:             | 
|    /usr/local/xunsearch/sdk/php/README          | 
+=================================================+ 

通过以下命令启动:

sudo bin/xs-ctl.sh start

以上命令默认在本地回环地址(127.0.0.1)8383/8384上监听服务,如果你有多台机器需要访问迅搜服务端,需要通过以下命令启动:

bin/xs-ctl.sh -b inet start

以上过程没有报错,就意味着迅搜已经正常启动了。

第二步:安装相关 PHP 扩展包

首先通过 Composer 安装 xunsearch 扩展包:

 composer require hightman/xunsearch

安装完迅搜扩展包后,在 Laravel 中使用 Scout 也需要安装对应扩展包

  composer require laravel/scout

安装完成之后打开 laravel 项目:

image.png

打开相关目录:

服务器项目路径 /vendor/hightman/xunsearch

打开之后呈现出一下画面:

image.png

之后打开app目录找到 demo.ini 文件打开看一下:


image.png

在上面所说的索引字段设置成你需要索引的字段名称例如:
userid,username,company,ip_area(根据需要索引的数据来进行设置)

第三步:在 laravel 项目中引入 xunsearch 类:

直接在 Controller 或者你需要用到的地方 Model 直接

use XS;

在方法中调用

$xs =  new XS('demo');

这里的 demo 默认选择了 laravel 项目中的 /vendor/hightman/xunsearch/app 下面的 demo.ini 文件 当然你也可以自己建立配置文件位置放在哪里你自己来定,剩下的具体用法请转入迅搜的官网去查看:http://www.xunsearch.com/

第四步:进行将数据库中的需要索引的表导入到服务器的索引配置中具体的索引配置可以去迅搜的官网查看:

(附链接:http://www.xunsearch.com/doc/php/guide/util.indexer

首先链接进入服务器到 xunseach 服务器的配置文件地址

cd /usr/local/xunsearch/sdk/php/app

打开 demo.ini 文件 发现和 laravel 项目里与没有改动之前的 demo.ini 文件一样,现在将它改成和 laravel 里的 demo.ini 一致
下面是我测试的数据字段


image.png

接下来进入到创建索引配置:

cd /usr/local/xunsearch/sdk/php
//下面这个命令是用来导入数据到你的索引配置文件
php util/Indexer.php --rebuild --source=mysql://你的数据库用户名:密码@localhost/你的项目数据库就是你要建立索引的数据库 --sql="SELECT userid,company,username,ip_area FROM xd_member" --project=demo

先看一下这个条命令 其中前半段如果想看明白的话那么可以去迅搜官网查看这里不详细说明,我们找到 --sql= 'SQL语句'

image.png

导入之后显示说明数据导入成功:


image.png

接下来进行测试一下吧~

  [root@bogon php]# util/Quest.php demo 山东
image.png

大功告成!!!!!!

推荐阅读更多精彩内容