Laravel如何编写满足多条件的带snooze功能的active查询Scope

你现有代码的核心问题有两个：一是OR条件没有做闭包嵌套，会导致逻辑混乱，甚至把项目原有Scope的其他筛选规则冲坏；二是空值判断的写法不规范，容易触发不同数据库的语法兼容问题。

修正后的代码 #

public function scopeActiveWithSnooze($query, $date)
{
    return $query->where(function ($query) use ($date) {
        // 条件1：active = true 且未设置 snooze 时间
        $query->where(function ($q) {
            $q->where('active', true)
              ->whereNull('snooze_start_date')
              ->whereNull('snooze_end_date');
        })
        // 条件2：active = true 且设置了snooze时间，当前日期不在 snooze 区间内
        ->orWhere(function ($q) use ($date) {
            $q->where('active', true)
              ->whereNotNull('snooze_start_date')
              ->whereNotNull('snooze_end_date')
              ->where(function ($subQ) use ($date) {
                  $subQ->whereDate('snooze_end_date', '<=', $date)
                       ->orWhereDate('snooze_start_date', '>=', $date);
              });
        })
        // 条件3：active = false 且设置了snooze时间，当前日期已过 snooze 结束时间自动激活
        ->orWhere(function ($q) use ($date) {
            $q->where('active', false)
              ->whereNotNull('snooze_end_date')
              ->whereDate('snooze_end_date', '<=', $date);
        });
    });
}

调整说明 #

• 最外层新增了闭包where包裹所有三个条件，确保这三个OR关系的规则整体作为一个筛选单元，不会和项目原有Scope的其他筛选条件产生逻辑冲突
• 用Laravel原生提供的whereNull/whereNotNull做字段空值判断，适配不同数据库的语法规范，避免直接写where('xxx', null)出现的隐式转换问题
• 条件2的日期区间判断单独嵌套了一层闭包，确保「日期不在snooze区间内」的逻辑只对当前组的条件生效，不会出现全局OR导致的逻辑错误
• 最后直接返回查询构造器，符合Laravel Scope的写法规范，支持后续链式调用其他查询方法

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