Laravel怎么实现搜索功能_Laravel使用Eloquent实现模糊查询与多条件搜索【实例】_网络技术

Laravel怎么实现搜索功能_Laravel使用Eloquent实现模糊查询与多条件搜索【实例】

发布时间 - 2025-12-26 00:00:00 点击率：次

Eloquent 模糊搜索应使用 where('field', 'like', "%{$keyword}%") 安全绑定，禁用 whereRaw 拼接；多条件搜索推荐 when() 链式调用避免嵌套。

用 `where()` 和 `like` 做基础模糊搜索

直接在 Eloquent 查询中拼接 LIKE 是最常见写法，但要注意 SQL 注入风险。Laravel 提供了安全的参数绑定方式，别手写 "%{$keyword}%" 拼字符串。

比如搜索用户昵称包含 “admin”：

use App\Models\User;

$users = User::where('nickname', 'like', '%admin%')->get();

如果关键词来自请求，必须用变量绑定：

$keyword = $request->input('q', '');
$users = User::where('nickname', 'like', "%{$keyword}%")->get();

⚠️ 错误示范：whereRaw("nickname LIKE '%{$keyword}%'") —— 无过滤时极易被注入
✅ 正确做法：用 like 操作符 + 双引号包裹带百分号的变量，Laravel 自动转义
? 区分大小写取决于数据库配置（如 MySQL 默认不区分，PostgreSQL 区分），需要统一可用 ilike（PostgreSQL）或 LOWER() 函数

组合多个搜索条件用 `when()` 避免 if 判断嵌套

当搜索表单有「用户名」「邮箱」「状态」「创建时间范围」等多个可选字段时，硬写一堆 if 会让查询构建逻辑混乱且难维护。when() 是 Laravel 专为这种场景设计的链式条件方法。

$users = User::when($request->filled('name'), function ($query) use ($request) {
    return $query->where('name', 'like', "%{$request->name}%");
})
->when($request->filled('email'), function ($query) use ($request) {
    return $query->where('email', 'like', "%{$request->email}%");
})
->when($request->filled('status'), function ($query) use ($request) {
    return $query->where('status', $request->status);
})
->when($request->filled('start_date'), function ($query) use ($request) {
    return $query->whereDate('created_at', '>=', $request->start_date);
})
->when($request->filled('end_date'), function ($query) use ($request) {
    return $query->whereDate('created_at', '<=', $request->end_date);
})
->paginate(15);

✅ filled() 比 has() 更稳妥：它排除空字符串、null、0 等“假值”，避免意外匹配
⚠️ 注意日期范围查询：用 whereDate() 而非 where()，否则可能因时间部分不匹配漏数据
? 如果某些字段需精确匹配（如 status）、某些需模糊（如 name），混用 where 和 where(..., 'like', ...) 完全没问题，when() 只是控制是否执行那段逻辑

全文搜索替代方案：MySQL `FULLTEXT` 或 PostgreSQL `tsvector`

当数据量上万、模糊查询变慢，或需要支持“相关度排序”“同义词”“中文分词”时，纯 LIKE 就力不从心了。Laravel 本身不封装全文索引，但可调用底层能力。

MySQL 示例（需提前建 FULLTEXT 索引）：

ALTER TABLE users ADD FULLTEXT(name, email);

然后在查询中用：

$keyword = $request->q;
$users = User::whereRaw("MATCH(name, email) AGAINST(? IN NATURAL LANGUAGE MODE)", [$keyword])
    ->orderByRaw("MATCH(name, email) AGAINST(?) DESC", [$keyword])
    ->get();

⚠️ 中文支持弱：MySQL 原生 FULLTEXT 对中文按字切分效果差，需配合 ngram 插件或改用 Elasticsearch
✅ PostgreSQL 的 to_tsvector + to_tsquery 对中文更友好（配合 zhparser 扩展）
? Laravel Scout 是官方推荐的扩展方案，但它是独立服务（Algolia / Meilisearch / TNTSearch），不是“开箱即用”的 Eloquent 方法，上线前得权衡部署成本

搜索结果分页时保留查询参数

用 paginate() 后点击第2页，URL 里搜索关键词丢了——这是新手最常踩的坑。Laravel 的 appends() 就是干这个的。

$users = User::when(...)->paginate(15);

// 在 Blade 中渲染分页时：
{{ $users->appends(request()->query())->links() }}

更稳妥的做法是只追加关键搜索字段，避免把无关参数（如 _token）也带上：

{{ $users->appends(request()->only(['q', 'status', 'start_date', 'end_date']))->links() }}

⚠️ 不要用 withQueryString()（Laravel 9+ 新增），它会无差别携带所有 query，可能暴露敏感参数
✅ only() 显式声明要保留的键，清晰可控
? 如果用了路由模型绑定或中间件修改了 request，确保 request()->only(...) 获取的是最终实际用于搜索的值

Eloquent 搜索看着简单，但多条件组合、参数透传、性能边界、中文支持这几处最容易出问题。尤其是 when() 的闭包里 use 变量和 paginate 后 appends 的配合，线上一疏忽就返回空结果还查不出原因。

# mysql # word # laravel # app # ai # 邮箱 # red # sql # 中间件 # NULL # if # 封装 # 字符串 # 堆 # 闭包 # elasticsearch # postgresql # 数据库 # 关键词 # 链式 # 绑定 # 多个 # 分页 # 多条 # 的是 # 这是 # 看着 # 切分

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号

下一篇：百度浏览器网页无法复制文字怎么办百度浏览器复制修复

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号

下一篇：百度浏览器网页无法复制文字怎么办百度浏览器复制修复