Laravel 8查询构造器逐步添加查询条件后如何实现分步回退

Laravel查询构造器条件追加行为说明 #

你观察到的自动追加查询条件的行为完全符合Laravel官方设计规范：Laravel Eloquent查询构造器（Illuminate\Database\Eloquent\Builder）及底层的基础查询构造器（Illuminate\Database\Query\Builder）均为可变对象，调用where等条件方法时会直接修改当前实例的属性，而非返回新的对象副本，该设计主要用于减少不必要的对象实例化开销，提升查询构造的性能。

回退到上一步查询状态的实现方案 #

• 方案1：提前克隆中间状态的查询对象（最推荐）
  提前为需要复用的中间查询状态创建克隆副本，避免后续条件修改影响原有状态，示例代码：

// 初始基础查询
$baseQuery = Restaurant::where('status', 'active');
// 保存第二步查询的副本
$step2Query = (clone $baseQuery)->where('id', '>', 3);
// 生成第三步带color条件的查询
$myRestaurants = (clone $step2Query)->where('color', 'red');

// 直接调用$step2Query即可得到你需要的回退后的查询构造器

• 方案2：手动移除最后添加的查询条件
  如果没有提前保存副本，你可以直接操作查询构造器的条件数组和参数绑定，移除最后追加的条件，示例代码：

// 移除最后一个where条件规则
array_pop($myRestaurants->getQuery()->wheres);
// 同步移除该条件对应的绑定参数
array_pop($myRestaurants->getQuery()->bindings['where']);

注意该方案仅适用于简单的链式追加条件场景，如果最后一个条件是嵌套查询、关联查询等复杂逻辑，需要同步校验绑定参数的对应关系，避免出现查询错误。

• 方案3：封装查询作用域复用逻辑
  你可以将不同阶段的查询逻辑封装为模型的本地作用域，按需调用即可避免状态污染，示例代码：

// 在Restaurant模型中定义作用域
public function scopeActive($query)
{
    return $query->where('status', 'active');
}

public function scopeIdGt3($query)
{
    return $query->where('id', '>', 3);
}

// 调用时按需组合即可
// 回退后的查询直接写作：
$myRestaurants = Restaurant::active()->idGt3();
// 完整查询写作：
$myRestaurants = Restaurant::active()->idGt3()->where('color', 'red');

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