xunsearch详细教程

阎鸿煊

2023-12-01

xunsearch详细教程

很多人在看xunsearch官网文档时，往往看不懂官网文档。那么，今天就来看看xunsearch到底如何使用。

搞懂xunsearch搜索的流程

其实，很多人看不懂xunsearch官方文档原因一般是：不知道xunsearch与MySQL数据库的关系，又或者根本没有使用过全文搜索。

a 为什么从xunsearch中可以搜索出MySQL中的数据

这是因为在我们在后台添加数据时，除了会往数据库中插入数据，还会将数据插入到xunsearch中。这就用到了xunsearch的"添加文档",具体教程请看：

    http://www.xunsearch.com/doc/php/guide/index.add

举个栗子：

假设我们想要在前台的搜索框中，输入商品名后就能搜索到商品。

其实这个时候，商品的相关数据已经被添加到xunsearch的索引数据库中。

具体说说：

b. 之后在做后台商品添加功能时，除了需要将商品数据插入到数据库中，还需要将商品数据添加到xunsearch的索引数据库中。

c. 只有当xunsearch的索引数据库中有数据，才可以搜索出来。

如何从xunsearch索引数据库中搜索到数据

当数据被添加到索引数据库后，我们就可以做搜索了。那么如何做搜索呢？请看步骤：

a. 第一步：明确你的项目中哪些数据是可以被搜索的

例如：我写一个博客，那么我想要被搜索的数据可能是：1. 文章标题 2. 文章内容

b. 第二步：确定你要搜索出来的内容有哪些

例如：我想要从xunsearch中搜索的内容有： 1. 文章标题 2. 文章作者 3. 文章主键

c. 根据前面2步，编写xunsearch配置文件

具体如何编写配置文件，以及配置文件一些参数描述，请自行看xunsearch文档：

    http://www.xunsearch.com/doc/php/guide/ini.guide

以下是我根据前面2步，编写出来的配置文件：

        project.name = shop
        project.default_charset = utf-8

        [id]
        type = id

        [title]
        index = self

        [author]

        [content]
        index = both

编写配置文件需要注意的问题：

a. 配置文件一般放在xunsearch安装目录下的sdk/php/app下

如果xunsearch安装到/usr/local/xunsearch目录下，那么配置文件就在：

/usr/local/xunsearch/sdk/php/app/shop.ini

shop.ini文件名要与配置文件中的project.name的值一致。

b. 配置文件中的参数讲解

由于需要搜索标题、文章作者、文章内容、文章主键，所以需要有[title]、[author]、[content]、[id]

[id]  id一般是与你的数据库的表的字段名一样,其他的也是一个意思

下面以Xunseach在Laravel中使用来讲解具体步骤

a. 第一步：编写好配置文件

将写好的配置文件放在/usr/local/xunsearch/sdk/php/app/目录下，配置文件名与project.name一致即可

b. 第二步：安装SDK

    $ composer require hightman/xunsearch

c. 第三步：使用SDK即可

具体代码，请到我的github下载，如果觉得好，记得给我点赞。

    https://github.com/cpphp/laravel-xunsearch/

xunsearch详细教程