README

Laravel 5 包，用于基于 XunSearch 的 Eloquent 模型全文搜索。

安装

在您的 composer.json 中添加此包并运行 composer update

{
	"require": {
            "xlstudio/xunsearch": "dev-master"
	}
}

更新 composer 后，将 ServiceProvider 添加到 app/config/app.php 文件中的 providers 数组中

'providers' => [
	Xlstudio\XunSearch\ServiceProvider::class,
],

如果您想使用外观搜索，请在 app/config/app.php 中的外观中添加此内容

'aliases' => [
	'Search' => Xlstudio\XunSearch\Facade::class,
],

配置

通过运行以下命令将配置文件发布到项目中

php artisan vendor:publish --provider="Xlstudio\XunSearch\ServiceProvider"

### 在发布的配置文件中为需要索引的模型添加描述，例如

//@see http://www.xunsearch.com/doc/php/guide/ini.guide
"project" => [
    "project.name" => "xunsearch",
    "project.default_charset" => "utf-8",
    "server.index" => "127.0.0.1:8383",
    "server.search" => "127.0.0.1:8384",
    //remember change FIELD_LABEL_DEFAULT_SEARCH_PK value in Config.php
    "primary_key" => [
        "type" => "id"
    ],
    //remember change FIELD_LABEL_DEFAULT_CLASS_ID value in Config.php
    "class_uid" => [
        "index" => "both"
    ],
    //remember change FIELD_LABEL_DEFAULT_DB_PK value in Config.php
    "id" => [
        "type" => "numeric"
    ],
    "subject" => [
        "type" => "title"
    ],
    "status" => [
        'type' => "numeric"
    ],
    "content" => [
        "type" => "body"
    ]
],

'index' => [
	
	// ...

	namespace\FirstModel::class => [
		'fields' => [
			'name', 'full_description', // fields for indexing
		],
		'primary_key' => 'id'  //primary_key name in DB, default 'id'
	],
	
	namespace\SecondModel::class => [
		'fields' => [
			'name', 'short_description', // fields for indexing
		]
	],
	
	// ...
	
],

使用方法

Artisan 命令

初始化或重建搜索索引

为构建搜索索引运行

php artisan search:rebuild --verbose

清除搜索索引

为清除搜索索引运行

php artisan search:clear

搜索结果中的模型过滤

为过滤搜索结果中的模型，每个模型的类可以实现 SearchableInterface 接口。例如

use Illuminate\Database\Eloquent\Model;
use Xlstudio\XunSearch\Model\SearchableInterface;

class Dummy extends Model implements SearchableInterface
{
        // ...

        /**
         * Get id list for all searchable models.
         */
        public static function searchableIds()
        {
            return self::wherePublish(true)->lists('id');
        }

        // ...
}

搜索索引的部分更新

为注册必要的（保存/更新/删除）事件，在目标模型中使用 use Xlstudio\XunSearch\Model\SearchTrait

    use Illuminate\Database\Eloquent\Model;
    use Xlstudio\XunSearch\Model\SearchableInterface;
    use Xlstudio\XunSearch\Model\SearchTrait;

    class Dummy extends Model implements SearchableInterface
    {
        use SearchTrait;
    
        // ...
    }

查询构建

以几种方式构建查询

使用构造函数

默认情况下，将创建执行 短语完全匹配 搜索的查询。

简单查询

$query = Model::getSearch()->addQuery("clock"); // search by all fields.
// or 
$query = Model::getSearch()->addQuery('name:clock'); // search by 'name' field.
// or
$query = Model::getSearch()->addQuery('name:clock'); // filter by 'short_description' field.

$Ids = Model::getSearch()->addQuery('name:clock')->getIDList(); // filter by 'short_description' field.

获取结果

对于构建的查询，以下操作可用

获取所有找到的模型

$models = $query->search();

获取所有找到的模型 ID

$models = $query->getIDList();

获取结果计数

$count = $query->count();

获取带有偏移量的限制结果

$models = $query->limit(5, 10)->get(); // Limit = 5 and offset = 10

排序

$query = $query->setSort('chrono', true);

匹配高亮显示

匹配高亮显示对于任何编码为 utf-8 的 html 片段都可用，并且仅对最后一次执行请求执行。

$docs = $search->setQuery('测试')->setLimit(5)->search();
foreach ($docs as $doc)
{
   $subject = $search->highlight($doc->subject); // 高亮处理 subject 字段
   $message = $search->highlight($doc->message); // 高亮处理 message 字段
   echo $doc->rank() . '. ' . $subject . " [" . $doc->percent() . "%] - ";
   echo date("Y-m-d", $doc->chrono) . "\n" . $message . "\n";
}

许可证

该包根据 MIT 许可证授权。