如何在 Laravel 8 的闭包查询中正确访问外部作用域变量

在 laravel 8 中使用 `where()` 闭包时，若需引用外部定义的变量（如 `$p1array`），必须通过 `use()` 关键字显式导入，否则会触发“undefined variable”错误。

在 laravel 的查询构造器中，闭包（如 where(function ($query) { … })）拥有独立的作用域，无法自动访问父作用域中的变量。这与 javaScript 的箭头函数或 python 的闭包行为不同——php 默认不继承外部变量，必须显式声明。

例如，以下写法会报错：

$p1Array = ['incharge_id' => 123, 'includeProcessJob' => true];  $job_bookings = DB::table('job_bookings')     ->where('client_id', '=', $p1Array['incharge_id'])     ->where(function ($query) {         if (Arr::has($p1Array, 'includeProcessJob')) { // ❌ $p1Array 未定义             $query->where('ndt_job_status_id', '=', 1)                   ->orWhere('ndt_job_status_id', '=', 2);         } else {             $query->where('ndt_job_status_id', '=', 1);         }     });

✅ 正确做法是使用 use($variable) 将所需变量传入闭包：

$p1Array = ['incharge_id' => 123, 'includeProcessJob' => true];  $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(&$variable) 引用传递；
• 可同时引入多个变量：use ($p1Array, $statusId, $isActive)；
• 避免在 use() 中传入大型对象或集合（如 Eloquent 模型实例），以防内存冗余；
• Laravel 的查询构造器链式调用中，每个闭包都需独立 use()，不可跨闭包共享。

总结：PHP 闭包的变量隔离机制是安全设计，而非缺陷。在 Laravel 查询中，牢记“凡闭包内需访问外部变量，必加 use()”，即可彻底规避 Undefined variable 错误，并写出清晰、可维护的动态查询逻辑。