Scout Elasticsearch Driver 使用教程
1. 项目介绍
Scout Elasticsearch Driver
是一个为 Laravel Scout 提供的 Elasticsearch 驱动扩展包。它允许你在 Laravel 应用中使用 Elasticsearch 进行高级搜索和数据过滤。该包提供了丰富的功能,包括索引配置、搜索规则、零停机迁移等,使得在 Laravel 项目中集成 Elasticsearch 变得更加简单和高效。
2. 项目快速启动
2.1 安装
首先,使用 Composer 安装 Scout Elasticsearch Driver
:
composer require babenkoivan/scout-elasticsearch-driver
2.2 配置
安装完成后,需要发布 Scout 和 Scout Elasticsearch Driver
的配置文件:
php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"
php artisan vendor:publish --provider="ScoutElastic\ScoutElasticServiceProvider"
然后,在 config/scout.php
文件中设置驱动为 elastic
:
'driver' => env('SCOUT_DRIVER', 'elastic'),
2.3 创建索引配置器
使用以下命令创建一个新的索引配置器:
php artisan make:index-configurator MyIndexConfigurator
在生成的 MyIndexConfigurator.php
文件中,你可以配置索引名称和设置:
namespace App;
use ScoutElastic\IndexConfigurator;
class MyIndexConfigurator extends IndexConfigurator
{
protected $name = 'my_index';
protected $settings = [
'analysis' => [
'analyzer' => [
'es_std' => [
'type' => 'standard',
'stopwords' => '_spanish_',
],
],
],
];
}
2.4 创建可搜索模型
使用以下命令创建一个新的可搜索模型:
php artisan make:searchable-model MyModel --index-configurator=MyIndexConfigurator
在生成的 MyModel.php
文件中,配置模型的索引配置器和映射:
namespace App;
use ScoutElastic\Searchable;
use Illuminate\Database\Eloquent\Model;
class MyModel extends Model
{
use Searchable;
protected $indexConfigurator = MyIndexConfigurator::class;
protected $searchRules = [];
protected $mapping = [
'properties' => [
'title' => [
'type' => 'text',
'fields' => [
'raw' => [
'type' => 'keyword',
],
],
],
],
];
}
2.5 创建和更新索引
创建索引:
php artisan elastic:create-index "App\MyIndexConfigurator"
更新模型映射:
php artisan elastic:update-mapping "App\MyModel"
2.6 基本搜索
现在你可以使用 Elasticsearch 进行搜索了:
$results = App\MyModel::search('phone')
->select(['title', 'price'])
->where('color', 'red')
->orderBy('price', 'asc')
->collapse('brand')
->from(0)
->take(10)
->get();
3. 应用案例和最佳实践
3.1 高级搜索
Scout Elasticsearch Driver
支持多种高级搜索功能,如布尔查询、地理距离过滤、正则表达式过滤等。以下是一个使用正则表达式过滤的示例:
$results = App\MyModel::search('*')
->whereRegexp('name.raw', 'A.+')
->get();
3.2 零停机迁移
在需要更改索引映射时,可以使用零停机迁移功能。首先,确保你的索引配置器使用了 ScoutElastic\Migratable
特性:
namespace App;
use ScoutElastic\IndexConfigurator;
use ScoutElastic\Migratable;
class MyIndexConfigurator extends IndexConfigurator
{
use Migratable;
protected $name = 'my_index';
}
然后,运行迁移命令:
php artisan elastic:migrate-model "App\MyModel" my_index_v2
4. 典型生态项目
4.1 Elastic Scout Driver
Elastic Scout Driver
是一个通用的 Elasticsearch 驱动,适用于需要简单搜索功能的 Laravel 应用。
4.2 Elastic Scout Driver Plus
Elastic Scout Driver Plus
是 Elastic Scout Driver
的扩展,提供了更多高级功能,如布尔查询、高亮显示等。
4.3 Elastic Migrations
Elastic Migrations
是一个用于管理 Elasticsearch 索引模式的工具,类似于 Laravel 的数据库迁移功能。
通过这些生态项目,你可以构建一个完整的 Elasticsearch 搜索解决方案,满足各种复杂搜索需求。
鸿蒙开发工具大赶集
本仓将收集和展示鸿蒙开发工具,欢迎大家踊跃投稿。通过pr附上您的工具介绍和使用指南,并加上工具对应的链接,通过的工具将会成功上架到我们社区。012yolo-onnx-java
Java开发视觉智能识别项目 纯java 调用 yolo onnx 模型 AI 视频 识别 支持 yolov5 yolov8 yolov7 yolov9 yolov10,yolov11,paddle ,obb,seg ,detection,包含 预处理 和 后处理 。java 目标检测 目标识别,可集成 rtsp rtmp,车牌识别,人脸识别,跌倒识别,打架识别,车牌识别,人脸识别 等Java00每日精选项目
🔥🔥 每日精选已经升级为:【行业动态】,快去首页看看吧,后续都在【首页 - 行业动态】内更新,多条更新哦~🔥🔥 每日推荐行业内最新、增长最快的项目,快速了解行业最新热门项目动态~~029frog
这是一个人工生命试验项目,最终目标是创建“有自我意识表现”的模拟生命体。Java00Cangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。Cangjie055毕方Talon工具
本工具是一个端到端的工具,用于项目的生成IR并自动进行缺陷检测。Python040PDFMathTranslate
PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/DockerPython06mybatis-plus
mybatis 增强工具包,简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.comJava03国产编程语言蓝皮书
《国产编程语言蓝皮书》-编委会工作区018- DDeepSeek-R1探索新一代推理模型,DeepSeek-R1系列以大规模强化学习为基础,实现自主推理,表现卓越,推理行为强大且独特。开源共享,助力研究社区深入探索LLM推理能力,推动行业发展。【此简介由AI生成】Python00
热门内容推荐
最新内容推荐
项目优选








