Laravel中when语句的工作原理及动态请求收集方式问询

先看实际使用示例：

$users = Model::when($param, function($query) {
    $query->where('id', 1);
})->get();

• 当$param存在且为真（非空、非零等）时，生成的SQL：

select * from table where id = 1

• 当$param不存在或为假时，生成的SQL：

select * from table

一、when方法的工作原理 #

when是Laravel查询构造器提供的条件化查询工具，核心作用就是简化条件判断式的查询逻辑，替代冗余的if-else代码：

1. 条件判断逻辑：方法的第一个参数是判断依据，Laravel会自动把它转为布尔值（比如非空字符串、非零数字都会被判定为true）。
2. 回调执行规则：
   • 如果条件为true，就执行第二个参数传入的闭包，闭包会拿到当前的查询构造器实例，你可以在闭包里调用where、orderBy等方法修改查询规则；
   • 你还可以传入第三个可选参数，当条件为false时执行对应的闭包逻辑；
3. 链式调用支持：无论条件是否满足，when方法都会返回原查询构造器实例，所以可以继续链式调用其他查询方法。

底层实现上，Illuminate\Database\Query\Builder类中的when方法就是做了简单的分支判断：条件为真就调用正向回调，为假则调用可选的反向回调，全程都是在同一个查询构造器实例上修改状态。

二、动态查询条件的收集方式 #

Laravel的查询构造器本质是一个查询状态容器，所有动态添加的查询规则都会被先存储起来，直到执行查询时才生成SQL：

1. 存储位置：查询构造器实例有一系列属性用来存储查询条件，比如$wheres数组专门存储WHERE子句的条件，$orders存储排序规则等。
2. 收集过程：当你在when的闭包里调用$query->where('id',1)时，其实是调用了查询构造器的where方法，该方法会把这条条件（包含字段、操作符、值、逻辑关系）添加到$wheres数组中。
3. SQL生成时机：当你调用get()、first()这类执行方法时，Laravel会触发SQL构建流程：遍历$wheres等属性里的条件，把它们拼接成标准的SQL片段，再组合成完整的SQL语句，最后通过数据库连接执行。

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