laravel Scout支持Algolia和Meilisearch实现全文搜索。1. 安装Scout并发布配置文件；2. 配置.env中的驱动和密钥；3. 模型引入Searchable trait；4. 导入数据并执行搜索；5. 可自定义索引字段和禁用同步。
在Laravel项目中实现高效的全文搜索，Laravel Scout 是官方推荐的解决方案。它为模型提供了简单、优雅的全文搜索支持，底层可集成 Algolia 或 Meilisearch 等搜索引擎。本文将指导你如何使用 Laravel Scout 集成 Algolia 和 Meilisearch，完成全文搜索功能。
安装与配置 Laravel Scout
Laravel Scout 可通过 composer 安装：
composer require laravel/scout
安装完成后，发布配置文件：
php artisan vendor:publish –provider=”LaravelScoutScoutServiceProvider”
这会在 config/scout.php 生成配置文件。默认驱动是 “algolia”，你可以根据需要切换为 “meilisearch”。
使用 Scout 集成 Algolia
Algolia 是一个强大的云端搜索服务，适合需要高性能搜索的应用。
1. 配置 Algolia 凭据
前往 Algolia 官网 注册并获取你的 application ID 和 Admin API Key。然后在 .env 文件中配置：
SCOUT_DRIVER=algolia
ALGOLIA_APP_ID=your_app_id
ALGOLIA_SECRET=your_admin_key 2. 为模型启用搜索功能
在需要搜索的 Eloquent 模型中引入 Searchable trait：
use LaravelScoutSearchable;
class Post extends Model
{
use Searchable;
}
该模型的数据将自动同步到 Algolia。
3. 导入已有数据
若数据库中已有数据，需将其导入 Algolia：
php artisan scout:import “AppModelsPost” 4. 执行搜索
在控制器或路由中使用搜索方法：
$results = AppModelsPost::search(‘ Laravel ‘)->get();
你也可以分页显示结果：
$results = AppModelsPost::search(‘ Laravel ‘)->paginate(15);
使用 Scout 集成 Meilisearch
Meilisearch 是开源、轻量且易于部署的搜索引擎，适合自托管项目。
1. 启动 Meilisearch 服务
使用 docker 快速启动：
docker run -it -p 7700:7700 getmeili/meilisearch:latest
默认主键为 masterKey，可在启动时指定：
docker run -it -p 7700:7700 -e MEILI_MASTER_KEY=your_master_key getmeili/meilisearch:latest 2. 安装 Meilisearch PHP 客户端
Scout 默认支持 Meilisearch，但确保已安装：
composer require meilisearch/meilisearch-php http-interop/http-factory-guzzle 3. 配置 .env 文件 SCOUT_DRIVER=meilisearch
MEILISEARCH_HOST=http://127.0.0.1:7700
MEILISEARCH_KEY=your_master_key 4. 在模型中使用 Searchable
与 Algolia 相同，只需引入 trait：
use LaravelScoutSearchable;
class Post extends Model
{
use Searchable;
} 5. 导入数据并搜索 php artisan scout:import “AppModelsPost”
执行搜索：
$results = AppModelsPost::search(‘教程’)->get();
自定义索引字段与搜索行为
默认情况下，Scout 会索引模型的所有属性。你可以重写 toSearchableArray() 方法来自定义数据：
public function toSearchableArray()
{
$array = $this->toArray();
return array_only($array, [‘title’, ‘content’, ‘author.name’]);
}
这样可以控制哪些字段被索引，提升性能和相关性。
如果想在保存模型时避免自动更新索引（例如在测试或批量操作时），可使用：
Post::withoutSyncingToSearch(function () {
// 批量创建或更新操作
}); 基本上就这些。Laravel Scout 让全文搜索变得简单，选择 Algolia 还是 Meilisearch 取决于你是否愿意托管还是自建服务。两者集成方式相似，切换方便，按项目需求选择即可。