README

介绍

这个包是在 laravel/scout 的服务中添加拓展，使用 XunSearch 搜索功能。

XunSearch 的安装，具体查看 XunSearch 的官方文档。

laravel/scout 的安装和使用，查看 laravel/scout 的官方文档。

安装

使用 composer

composer require taxusorg/xunsearch-laravel

在配置文件中添加服务提供者（Laravel5.5 及以上有自动添加）

'providers' => [
    //...
    Taxusorg\XunSearchLaravel\XunSearchServiceProvider::class,
    //...
],

复制配置文件到配置目录，配置文件内容不多，而且可以在 .env 文件中设置。手动复制或者使用命令复制：

php artisan vendor:publish --provider="Taxusorg\XunSearchLaravel\XunSearchServiceProvider"

修改 scout 配置文件 config/scout.php，让 scout 使用 XunSearch 引擎

    'driver' => env('SCOUT_DRIVER', 'xunsearch'),

或者直接在 .env 文件中设置

SCOUT_DRIVER=xunsearch

修改 XunSearch 配置文件 config/xunsearch.php

    'server_host' => env('XUNSEARCH_SERVER_HOST', '127.0.0.1'),
    'server_index_host' => env('XUNSEARCH_SERVER_INDEX_HOST', null),
    'server_index_port' => env('XUNSEARCH_SERVER_INDEX_PORT', '8383'),
    'server_search_host' => env('XUNSEARCH_SERVER_SEARCH_HOST', null),
    'server_search_port' => env('XUNSEARCH_SERVER_SEARCH_PORT', '8384'),
    'default_charset' => env('XUNSEARCH_DEFAULT_CHARSET', 'utf-8'),

或者直接在 .env 文件中设置需要修改的内容，没有特殊情况默认即可

XUNSEARCH_SERVER_HOST=127.0.0.1

使用

在 Model 中使用搜索功能，先引入 Searchable Trait，详见 Scout 使用文档。

use Illuminate\Database\Eloquent\Model;
use Laravel\Scout\Searchable;

class Blog extends Model
{
    use Searchable;

要使用 XunSearch， Model 还要实现指定接口，同时如果有需要，可以使用 XunSearchTrait Trait。 Trait 中注册了范围检索方法 range 等 XunSearch 可用的方法。也可以通过 xunSearch 方法获取 XSSearch 对象并进行检索设置。若不使用 Trait，可以通过 Model::search() 方法的回调对 XSSearch 设置并检索，对结果自行通过 XunSearchEngine::map 方法处理结果或自行对结果进行处理。实现接口需要添加 xunSearchFieldsType 方法进行字段类型设置

use Illuminate\Database\Eloquent\Model;
use Laravel\Scout\Searchable;
use Taxusorg\XunSearchLaravel\XunSearchModelInterface;
use Taxusorg\XunSearchLaravel\XunSearchTrait;

class Blog extends Model implements XunSearchModelInterface
{
    use Searchable, XunSearchTrait;
    
    public function xunSearchFieldsType()
    {
        return [
            'id' => [
                'type'=>self::XUNSEARCH_TYPE_NUMERIC,
            ],
            'title' => [
                'type'=>self::XUNSEARCH_TYPE_TITLE,
            ],
            'body' => [
                'type'=>self::XUNSEARCH_TYPE_BODY,
            ],
            'field' => [
                'tokenizer'=>self::XUNSEARCH_TOKENIZER_XLEN,
                'tokenizer_value'=>2,
            ],
            'created_at' => [
                'type'=>self::XUNSEARCH_TYPE_DATE,
                'index'=>self::XUNSEARCH_INDEX_NONE,
            ],
        ];
    }

设置的字段类型的具体效果，查看 XunSearch 官方文档。

Model 的主键，例如 id，已被默认设为引擎的文档主键。如果需要对 id 进行区间检索，把 id 的类型设为 self::XUNSEARCH_TYPE_NUMERIC。如果不需要对 id 进行检索，可以不添加 id 字段。

字段类型 self::XUNSEARCH_TYPE_TITLE 和 self::XUNSEARCH_TYPE_BODY 只能分别设置一次。

XunSearchTrait 中给 Scout 的 Builder 注册了 range 方法进行区间检索。除了 title 和 body 特殊字段， XunSearch 默认设定字段为 string，需要进行区间检索的字段，要设为 numeric 或者 date 才能正常检索。

例如设定 id 字段为 self::XUNSEARCH_TYPE_NUMERIC，在 id 大于 20 小于等于 60 的范围内搜索 word

Blog::search('word')->range('id', 20, 60)->get();

字段的索引 index 和分词器 tokenizer 的设置效果，在 XunSearch 官方文档查看。

更新

3.0.x

修改接口名称和路径
每一个 builder 对应一个 XS 对象，可以通过 Trait 添加的方法获取或者调用 XS 对象的方法

2.1.x

XunSearchTrait 中移除 cleanSearchable 方法，请使用 Scout 中的 removeAllFromSearch 方法。

muzidudu / xunsearch-laravel

Maintainers

Details

README

介绍

安装

使用

更新

相关链接