
在 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() 的语义和作用域规则,能有效避免运行时错误,并写出更健壮、可维护的数据库查询逻辑。










