首先安装 Laravel Scout 并选择合适的搜索驱动，接着配置环境变量与驱动连接信息，然后为 Eloquent 模型引入 Searchable trait 以启用搜索功能，再通过 Artisan 命令将现有数据导入索引，最后使用简洁的 API 执行全文搜索并支持分页与条件过滤。
如果您需要在 Laravel 应用中实现高效的全文搜索功能，但发现数据库原生查询性能不足或功能有限，则可以集成 Laravel Scout 来解决此问题。Laravel Scout 为 Eloquent 模型提供了简单、流畅的全文搜索支持，通过驱动机制可对接多种搜索引擎。
本文运行环境：MacBook Pro，
mac
OS Sonoma
一、安装 Laravel Scout 及选择搜索驱动
要使用 Laravel Scout，首先需要通过 Composer 安装核心包。Scout 本身是一个抽象层，需配合具体的搜索驱动（如 Algolia、Meilisearch、Elasticsearch 或 PostgreSQL）来实现索引和搜索功能。选择合适的驱动取决于部署环境和需求。
1、执行命令安装 Laravel Scout：
composerrequirelaravel/scout
2、在
文件的
数组中注册服务提供者：
Laravel\Scout\ScoutServiceProvider::class
3、生成配置文件：
phpartisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"
4、根据实际选用的搜索引擎安装对应扩展包：
- 使用 Meilisearch：
composer require meilisearch/meilisearch-php
- 使用 Elasticsearch：
composer require elasticsearch/elasticsearch
- 使用 PostgreSQL 全文搜索：
composer require pmatseykanets/laravel-scout-postgres
二、配置 Scout 驱动及
环境变量
安装完成后，需在
文件中指定 Scout 使用的驱动，并设置对应驱动的连接信息。配置分离有助于在不同环境中切换搜索引擎。
1、在
文件中设置驱动类型，例如使用 Meilisearch：
SCOUT_DRIVER=meilisearch
2、添加 Meilisearch 的主机地址和密钥：
MEILISEARCH_HOST=http://127.0.0.1:7700
和
MEILISEARCH_KEY=your_master_key
3、若使用 Algolia，则配置：
ALGOLIA_APP_ID=your_app_id
和
ALGOLIA_SECRET=your_secret
4、对于 PostgreSQL 驱动，在
中设置：
'driver' => 'pgsql'
，并确保数据库连接正确
5、清除配置缓存以应用更改：
php artisan config:clear
三、为 Eloquent 模型启用搜索功能
要使某个 Eloquent 模型具备搜索能力，需引入
trait。该 trait 会自动监听模型的增删改操作，并同步更新搜索引擎中的索引数据。
1、在目标模型文件中引入命名空间并使用 trait，例如对
模型：
use Laravel\Scout\Searchable;
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
class Post extends Model { use Searchable; }
2、可选：自定义索引名称，通过重写
方法指定：
public function searchableAs() { return 'posts_index'; }
3、可选：控制哪些数据被索引，重写
方法返回需要的数据字段
四、导入数据至搜索索引
对于已有数据的模型，需将数据库中的记录同步到搜索引擎的索引中。Scout 提供了 Artisan 命令来批量导入数据。
1、执行命令将指定模型的所有数据导入索引：
php artisan scout:import "App\Models\Post"
2、若使用支持索引管理的驱动（如 Meilisearch），可先创建索引：
php artisan scout:index posts
3、对于增量数据，模型在保存时会自动触发索引更新。也可手动调用：
$post->searchable()
4、删除模型时自动从索引移除，也可手动取消索引：
$post->unsearchable()
五、执行全文搜索查询
启用并导入数据后，即可在控制器或服务中调用搜索方法进行全文检索。Scout 提供简洁的 API 来构建搜索查询。
1、在控制器中使用模型的
方法传入关键词：
$results = App\Models\Post::search('Laravel')->get();
2、支持分页显示结果：
$results = App\Models\Post::search('Scout')->paginate(15);
3、可链式调用 Eloquent 查询作用域进行条件过滤：
Post::search('full-text')->where('published', 1)->get()
4、获取原始搜索结果元信息（如高亮、相关性得分）可通过
方法访问底层响应
config/app.phpproviders.env.envconfig/scout.phpSearchableApp\Models\PostsearchableAstoSearchableArraysearchraw()