信息发布→ 登录 注册 退出

Laravel Scout是什么,如何集成MeiliSearch或Algolia实现全文搜索

发布时间:2025-11-15

点击量:
Laravel Scout通过Algolia或MeiliSearch实现全文搜索,先安装Scout并配置驱动,模型使用Searchable trait后即可同步数据并执行搜索。1. 安装Scout:composer require laravel/scout;2. 发布配置文件:php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider";3. 配置Algolia:设置SCOUT_DRIVER、ALGOLIA_APP_ID和ALGOLIA_SECRET;4. 模型引入Searchable;5. 导入数据:php artisan scout:import "App\Models\Post";6. 执行搜索:Post::search('Laravel')->get()。MeiliSearch步骤类似,需安装对应客户端并配置MEILISEARCH_HOST。注意主键类型限制及敏感字段过滤,可使用toSearchableArray控制索引内容,关闭自动同步用withoutSyncingToSearch。Algolia适合托管需求,MeiliSearch更适合自建项目。

Laravel Scout 是 Laravel 提供的一个官方扩展包,用于为 Eloquent 模型添加全文搜索支持。它通过抽象搜索逻辑,让你可以用类似 Eloquent 的语法进行搜索操作,而无需手动编写复杂的查询语句。Scout 支持多种搜索引擎驱动,其中最常用的是 Algolia 和 MeiliSearch。

安装与配置 Laravel Scout

在使用任何搜索引擎之前,需要先安装 Laravel Scout:

composer require laravel/scout

安装完成后,在 config/app.php 中注册服务提供者(Laravel 5.5+ 可跳过,已支持自动发现):

'providers' => [ Laravel\Scout\ScoutServiceProvider::class, ]

发布配置文件:

php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"

这会在 config/scout.php 生成配置文件,你可以在这里设置默认驱动和相关选项。

集成 Algolia 实现全文搜索

Algolia 是一个功能强大的托管搜索服务,Scout 原生支持它。

1. 安装 Algolia 的 PHP 客户端:

composer require algolia/algoliasearch-client-php

2. 在 .env 文件中配置 Algolia 凭据:

SCOUT_DRIVER=algolia ALGOLIA_APP_ID=your_app_id ALGOLIA_SECRET=your_admin_key

3. 在模型中使用 Searchable trait:

use Laravel\Scout\Searchable; class Post extends Model { use Searchable; }

4. 将现有数据导入 Algolia:

php artisan scout:import "App\Models\Post"

5. 执行搜索:

Post::search(' Laravel ')->get();

集成 MeiliSearch 实现全文搜索

MeiliSearch 是一个开源、轻量级且快速的搜索引擎,适合自托管项目。

1. 安装 MeiliSearch 驱动:

composer require meilisearch/meilisearch-php http-interop/http-factory-guzzle

2. 设置驱动为 MeiliSearch,在 .env 中:

SCOUT_DRIVER=meilisearch MEILISEARCH_HOST=http://127.0.0.1:7700 MEILISEARCH_KEY=masterKey (可选,如果启用了密钥)

3. 启动 MeiliSearch 服务(需提前下载运行):

./meilisearch --master-key="masterKey"

4. 在模型中使用 Searchable trait(同上):

use Laravel\Scout\Searchable; class Post extends Model { use Searchable; }

5. 导入数据到 MeiliSearch:

php artisan scout:import "App\Models\Post"

6. 执行搜索:

Post::search('教程')->get();

常见注意事项

确保模型主键是字符串或整数,Scout 对复合主键支持有限。

每次模型保存时会自动同步到搜索引擎,如需临时关闭,可在代码中使用:

Post::withoutSyncingToSearch(function () { // 创建或更新模型 });

如果字段内容不希望被索引,可在模型中定义 toSearchableArray() 方法过滤:

public function toSearchableArray() { return $this->only('id', 'title', 'content'); }

基本上就这些。Laravel Scout 让集*文搜索变得简单,选择 Algolia 还是 MeiliSearch 主要取决于是否愿意托管还是自建服务。两者都高效稳定,MeiliSearch 更适合注重隐私和成本控制的项目,Algolia 则提供更完善的管理界面和高可用性。配置完成后,搜索就像写 Eloquent 查询一样自然。

标签:# function  # 让你  # 在这里  # 先安装  # 客户端  # 的是  # 更适合  # 可在  # 主键  # 是一个  # http  # this  # php  # public  # class  # 字符串  # require  # 配置文件  # 搜索引擎  # ai  # app  # composer  # go  # laravel  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!