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:
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 是一个功能强大的托管搜索服务,Scout 原生支持它。
1. 安装 Algolia 的 PHP 客户端:
composer require algolia/algoliasearch-client-php2. 在 .env 文件中配置 Algolia 凭据:
SCOUT_DRIVER=algolia ALGOLIA_APP_ID=your_app_id ALGOLIA_SECRET=your_admin_key3. 在模型中使用 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 是一个开源、轻量级且快速的搜索引擎,适合自托管项目。
1. 安装 MeiliSearch 驱动:
composer require meilisearch/meilisearch-php http-interop/http-factory-guzzle2. 设置驱动为 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 查询一样自然。
以上就是Laravel Scout是什么,如何集成MeiliSearch或Algolia实现全文搜索的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号