首先安装 laravel scout 和 algolia sdk，发布配置文件并设置 .env 中的 api 密钥；接着在模型中引入 searchable trait，可选自定义索引名和字段；然后运行 php artisan scout:import 导入现有数据；最后通过 post::search('query')->get() 执行搜索，实现高效实时全文检索。
想在 Laravel 项目里快速实现强大、实时的全文搜索？Laravel Scout 结合 Algolia 是个高效的选择。Scout 提供了优雅的 Eloquent 模型集成，而 Algolia 则负责提供闪电般速度和高级功能（如模糊匹配、拼写纠正）的搜索服务。整个过程并不复杂，跟着几个关键步骤就能搞定。
安装与基础配置
第一步是把需要的包装好。Scout 作为 Laravel 的官方搜索扩展包，必须先安装，然后根据你选用的驱动再安装对应的 SDK。这里我们用 Algolia。
- 安装依赖： 在你的 Laravel 项目根目录运行以下两条 Composer 命令。 composer require laravel/scout composer require algolia/algoliasearch-client-php
-
发布配置： 安装完成后，执行 Artisan 命令来生成 Scout 的配置文件。
php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"
这个命令会在
config目录下创建一个scout.php文件。 -
环境变量设置： 打开项目的
.env文件，添加 Algolia 的认证信息。你需要先去 Algolia 官网注册一个账号（有免费额度），然后在 “API Keys” 页面找到你的 ID 和密钥。 SCOUT_DRIVER=algolia ALGOLIA_APP_ID=your_application_id ALGOLIA_SECRET=your_admin_api_key
模型集成与数据索引
配置好后，接下来就是让你的数据模型支持搜索。这通常只需要对 Eloquent 模型做一点改动。
-
引入 Searchable Trait： 在你想要支持搜索的模型类中，use
Laravel\Scout\Searchable这个 trait。例如，让你的应用文章可搜索：use Laravel\Scout\Searchable; class Post extends Model { use Searchable; }加入这个 trait 后，模型的创建、更新、删除操作会自动同步到 Algolia 索引中。 -
自定义索引名称（可选）： 默认情况下，Scout 会使用模型的复数形式作为索引名（如 posts）。你可以通过重写
searchableAs()方法来指定一个更清晰或带前缀的名字。public function searchableAs() { return 'posts_index'; } -
选择索引字段（可选）： 默认会将模型的所有属性都存入索引。如果你只想索引部分字段，或者需要对数据进行加工，就重写
toSearchableArray()方法。public function toSearchableArray() { $array = $this->toArray(); // 只返回标题和内容，并确保内容是字符串 return [ 'title' => $array['title'], 'content' => strip_tags($array['content']), ]; }
导入数据与执行搜索
模型配置好了，但数据库里已有的老数据不会自动进到 Algolia。你需要手动触发一次全量导入，之后的增删改才会自动同步。
- 批量导入现有数据： 使用 Artisan 命令，将数据库中的所有记录一次性推送到 Algolia。 php artisan scout:import "App\Models\Post" 运行成功后，登录 Algolia 后台，你应该能在对应的索引里看到数据了。
-
执行搜索查询： 在控制器或任何你想用搜索的地方，直接在模型上调用
search()方法。// 在控制器中 $results = Post::search('Laravel')->get();search()方法接收一个关键词字符串，返回一个集合（Collection），里面是匹配的模型实例。你也可以链式调用其他 Eloquent 方法来进一步过滤结果。
基本上就这些。一套流程走下来，你的 Laravel 应用就有了一个响应迅速、功能现代的全文搜索引擎。不复杂但容易忽略的点是环境变量和首次数据导入，确保这两步没错，后续就都是自动的了。
