在 laravel 8 中，使用 `where()` 方法传入闭包时，闭包默认无法访问父作用域的局部变量（如 `$p1array`），需通过 `use()` 显式引入，否则会触发“undefined variable”错误。
在 Laravel 查询构造器中，闭包（如 where(function ($query) { … })）拥有独立的作用域，不会自动继承外部变量。这与 JavaScript 的箭头函数或 Python 的嵌套作用域不同——PHP 的匿名函数默认是“封闭”的，必须显式声明要捕获的变量。
你遇到的错误：
->where(function($query) {
if (Arr::has($p1Array, 'includeProcessJob')) { // ❌ $p1Array 未定义
// ...
}
})
根本原因就是 $p1Array 未被传递进闭包作用域。而外部链式调用 ->where(‘client_id’, ‘=’, $p1Array[‘incharge_id’]) 能正常运行，是因为它处于当前函数作用域内，不涉及闭包隔离。
✅ 正确做法：使用 use() 关键字将所需变量显式引入闭包：
$job_bookings = DB::table('job_bookings')
->where('client_id', '=', $p1Array['incharge_id'])
->where(function ($query) use ($p1Array) { // ✅ 声明捕获 $p1Array
if (Arr::has($p1Array, 'includeProcessJob')) {
$query->where('ndt_job_status_id', '=', 1)
->orWhere('ndt_job_status_id', '=', 2);
} else {
$query->where('ndt_job_status_id', '=', 1);
}
});
⚠️ 注意事项：
- use() 中的变量是按值传递（默认行为），若需在闭包内修改并影响外部变量，需加 & 引用符号（如 use (&$p1Array)），但此处通常无需修改；
- 可同时引入多个变量：use ($p1Array, $statusId, $clientId)；
- 避免在 use() 中传入大型对象或资源（如 Eloquent 模型实例），以防内存泄漏或意外状态耦合；
- 若逻辑复杂，建议将条件判断提前提取为布尔变量，提升可读性：
$shouldIncludeProcessing = Arr::has($p1Array, 'includeProcessJob');
$job_bookings = DB::table('job_bookings')
->where('client_id', '=', $p1Array['incharge_id'])
->where(function ($query) use ($shouldIncludeProcessing) {
if ($shouldIncludeProcessing) {
$query->whereIn('ndt_job_status_id', [1, 2]);
} else {
$query->where('ndt_job_status_id', '=', 1);
}
});
这是 Laravel 查询构建中一个高频且易错的知识点。掌握 use() 的语义和作用域规则，能有效避免运行时错误，并写出更健壮、可维护的数据库查询逻辑。