Laravel如何利用Eloquent实现全文检索？（高效方案）-Laravel-PHP中文网

mysql全文索引+match() against()是最稳起点，需建fulltext索引、用text/varchar字段，5.6+支持innodb，中文需分词或通配符处理。

laravel如何利用eloquent实现全文检索？（高效方案）

MySQL全文索引 + `match() against()` 是最稳的起点

直接上 match() against()，别一上来就装 Scout 或 Algolia。Laravel 默认没开 MySQL 全文索引支持，但原生 SQL 能力足够强，且无额外服务依赖。

常见错误是建表时没加 FULLTEXT 索引，或者字段类型不匹配（TEXT 或 VARCHAR 可以，JSON 字段不行）。

先在迁移里加索引：DB::statement("ALTER TABLE posts ADD FULLTEXT(title, content)")
Eloquent 查询写法：Post::whereRaw("MATCH(title, content) AGAINST(? IN NATURAL LANGUAGE MODE)", [$keyword])->get()
注意：MySQL 5.6+ 才支持 InnoDB 的全文索引；MyISAM 虽支持但已淘汰，别用
IN NATURAL LANGUAGE MODE 对短词（如“php”）效果差，搜不到就换 IN BOOLEAN MODE，支持 +、-、* 通配

Laravel Scout + `mysql` 驱动能省事，但得改默认行为

Scout 默认只监听 created、updated、deleted，但全文检索常要实时同步字段内容（比如把 content 和 title 合成一个 searchableAs() 字段），否则搜不到。

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

重写模型的 toSearchableArray()：return ['title' => $this->title, 'content' => $this->content];
必须手动触发索引更新：php artisan scout:import "App\Models\Post"，首次或结构变更后必跑
mysql 驱动本质还是走 match() against()，但它会自动建索引、拼 SQL，适合不想手写 raw 的人
性能上没本质提升，反而多一层抽象；并发高时要注意 queue 配置，否则搜索结果延迟

中文分词问题不是 Laravel 的锅，是 MySQL 的限制

MySQL 原生全文索引对中文支持极弱——它按空格/标点切词，而中文没空格。搜“数据库优化”大概率失败，除非你提前用空格隔开“数据库优化”。

硬解法：用 IN BOOLEAN MODE + 星号通配，比如 "数据库*"，但精度低、易误召
实用妥协：前端搜索前做简单分词（用 preg_split('/(? 拆单字），再拼成 <code>+"数" +"据" +"库"
真要高质量中文搜索，就得换引擎（MeiliSearch / Typesense），Scout 支持无缝切换，但部署成本立刻上升
别信“改 ft_min_word_len 就行”，那是针对英文最小词长，对中文无效

`whereFullText()` 不是 Eloquent 内置方法，别被文档误导

很多文章写的 Post::whereFullText('title', $q)->get() 是假的——Eloquent 根本没有这个方法，要么是自定义 Scope，要么是 Scout 扩展，要么是抄错代码。

查源码就知道：Eloquent Builder 里没定义 whereFullText，Laravel 官方也从未提供
如果看到别人用了，八成是封装了 whereRaw("MATCH(...) AGAINST(...)") 的本地 Scope
自己加也行，但注意参数注入安全：protected static function booted() { static::addGlobalScope('fulltext', new FullTextScope()); }
更轻量的做法：直接在模型里写个作用域方法，public function scopeWhereFullText($query, $columns, $keyword) { ... }

真正卡住人的从来不是语法，而是 MySQL 全文索引的隐式行为：停用词表、最小词长、布尔模式下引号和括号的优先级。调一次 SELECT @@ft_stopword_file, @@ft_min_word_len，比翻三页文档有用。