本文介绍如何在 Laravel 中优雅、可读性强且高效地根据非空过滤值动态添加 where 或 whereIn 查询条件，避免冗长的 if-else 嵌套，提升代码可维护性。
本文介绍如何在 laravel 中优雅、可读性强且高效地根据非空过滤值动态添加 `where` 或 `wherein` 查询条件，避免冗长的 if-else 嵌套，提升代码可维护性。
在构建多条件筛选报表或 API 接口时，前端常传递多个可选参数（如状态、日期范围、分类 ID 等），后端需仅对非空/有效值应用对应查询约束。若采用传统 if 判断逐条拼接查询，不仅代码臃肿，还易遗漏条件或引发 SQL 错误（如对空数组调用 whereIn）。
Laravel 提供了高度推荐的 when() 方法（自 5.3 起支持），专为条件式查询链设计：它接收一个判断值（truthy/falsy）、一个回调函数（条件成立时执行）和一个可选的 else 回调（条件不成立时执行），完美契合本场景。
以下是重构后的专业写法（含关键细节处理）：
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 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
$per_page = $request->input('per_page', 20);
// 预处理输入（保持语义清晰，避免重复逻辑）
$input1 = $request->input('input1');
$start_date = $request->filled('start_date')
? $request->input('start_date') . ' 00:00:00'
: null;
$end_date = $request->filled('end_date')
? $request->input('end_date') . ' 23:59:59'
: null;
$process = $request->input('process');
$status = $request->input('status');
$assigned_user = $request->input('user_id');
// 构建动态查询链（核心：使用 when() + filled()/isNotFilled()）
$items = DB::table('transactions_tbl')
->select('transactions_tbl.*', 'table1.name as tbl1_name', 'table2.title as tbl2_title') // 替换为实际字段数组
->leftJoin('tbl_1 as table1', 'table1.id', '=', 'transactions_tbl.tbl1_f_key')
->leftJoin('tbl_2 as table2', 'table2.id', '=', 'transactions_tbl.tbl2_f_key')
// ✅ input1：仅当非空时添加 where
->when($input1, fn ($query) => $query->where('transactions_tbl.input1', $input1))
// ✅ process：区分单值 vs 多值逻辑
->when(
$request->filled('process'),
fn ($query) => $query->where('transactions_tbl.process', $process),
fn ($query) => $query->whereIn('transactions_tbl.process', [1, 2, 3, 4])
)
// ✅ 日期范围：同时校验起止时间（避免无效区间）
->when($start_date && $end_date, fn ($query) =>
$query->whereBetween('transactions_tbl.created_at', [$start_date, $end_date])
)
->when($start_date && ! $end_date, fn ($query) =>
$query->where('transactions_tbl.created_at', '>=', $start_date)
)
->when(! $start_date && $end_date, fn ($query) =>
$query->where('transactions_tbl.created_at', 'when($status, fn ($query) => $query->where('transactions_tbl.status', $status))
->when($assigned_user, fn ($query) => $query->where('transactions_tbl.user_id', $assigned_user))
->paginate($per_page);
关键要点说明：
- ✅ filled() vs isNotFilled()：推荐使用 $request->filled('key')（等价于 !empty() 且更安全），而非手动判断 != ''；isNotFilled() 是其反向逻辑，但语义稍弱，建议统一用 filled()。
- ✅ whereIn 安全边界：示例中默认提供 [1,2,3,4] 数组，确保即使前端未传 process，也不会因空数组导致 SQL 错误（WHERE IN () 语法非法）。
- ✅ 日期处理优化：将 end_date 补充为 '23:59:59' 更符合业务常见需求（覆盖全天），并拆分三种时间范围组合，避免逻辑漏洞。
- ✅ 闭包简写：Laravel 9+ 支持箭头函数（fn()），大幅提升链式调用可读性；若用旧版本，替换为 function ($query) { ... } 即可。
- ⚠️ 性能提示：when() 不影响查询性能，它仅控制查询构建阶段的逻辑分支，最终生成的 SQL 与手写条件完全一致。
通过 when() 方法，你将原本可能超过 20 行的嵌套判断，压缩为结构清晰、职责单一、易于单元测试的链式表达——这才是 Laravel “表达力即生产力”的最佳体现。
