Laravel Eloquent动态查询：如何按需加入可选字段查询条件

当然可以！Laravel Eloquent早就为这种「可选字段按需加入查询」的场景准备了完美的解决方案——when() 方法，比写一堆零散的if判断清爽太多了，完全符合你要的「变量有值就追加条件，没值就自动忽略」的需求。

核心实现思路 #

when() 方法的逻辑很简单：它接受两个参数，第一个是判断条件（比如你的可选字段是否有值），第二个是条件成立时要执行的查询闭包。如果第一个参数为false（比如字段为空），闭包里的查询逻辑会直接被跳过，完全不用手动写分支判断。

针对你场景的代码示例 #

假设你的模型是Event（对应事件表），必填字段是status（比如必须是已发布状态），可选字段是date和location，代码可以这么写：

// 从请求中获取可选参数，没有值时默认返回null
$selectedDate = request()->input('date');
$selectedLocation = request()->input('location');

// 先构建必填字段的基础查询
$eventsQuery = Event::where('status', 'published');

// 用when()按需追加可选条件
$eventsQuery->when($selectedDate, function ($query) use ($selectedDate) {
    // 当selectedDate有值时，添加日期匹配条件
    return $query->where('event_date', $selectedDate);
})->when($selectedLocation, function ($query) use ($selectedLocation) {
    // 当selectedLocation有值时，添加地点匹配条件
    return $query->where('location', $selectedLocation);
});

// 执行查询，得到结果
$filteredEvents = $eventsQuery->get();

进阶用法：更复杂的可选条件 #

如果你的可选字段需要更复杂的逻辑（比如日期范围、模糊搜索），也可以在when()的闭包里灵活实现：

例子1：日期范围查询（当同时有开始和结束日期时才生效）

$startDate = request()->input('start_date');
$endDate = request()->input('end_date');

$eventsQuery->when($startDate && $endDate, function ($query) use ($startDate, $endDate) {
    return $query->whereBetween('event_date', [$startDate, $endDate]);
});

例子2：地点模糊搜索

$locationKeyword = request()->input('location_keyword');

$eventsQuery->when($locationKeyword, function ($query) use ($locationKeyword) {
    return $query->where('location', 'like', "%{$locationKeyword}%");
});

为什么比if语句更好？ #

• 可读性更强：链式调用的结构让查询逻辑一目了然，不用在一堆if里跳来跳去
• 维护成本更低：后续新增可选字段时，只需要多追加一个when()即可，不用修改现有分支
• 代码更简洁：省去了重复的if (!empty($xxx))判断，减少冗余代码

内容的提问来源于stack exchange，提问作者Aaron