在 laravel 应用开发中，我们经常会遇到需要遍历一个集合（collection）并根据其元素来操作另一个外部变量或集合的场景。一个典型的例子是，我们有一批奖品（prize）和一批票据（ticket），每个奖品需要分配一个唯一的票据。直观的思路是遍历奖品集合，每次从票据集合中随机选择一张，分配给当前奖品，然后将这张票据从票据集合中移除，以确保后续分配的票据都是唯一的。
然而，在实际操作中，如果不对 PHP 闭包（Closure）的变量作用域和传递机制有深入理解，可能会遇到意想不到的问题。
问题描述与初始尝试
假设我们有 Prize 和 Ticket 两个模型，并且希望为前 5 个奖品各分配一张唯一的票据。以下是常见的初始尝试代码：
use App\Models\Prize;
use App\Models\Ticket;
use Illuminate\Support\Collection;
// 假设 Prize 和 Ticket 模型已存在且包含数据
$prizes = Prize::all()->take(5); // 建议使用 take() 代替 limit()
$tickets = Ticket::all()->take(5);
// 遍历奖品集合，尝试分配唯一票据
$prizes->each(function ($prize, $key) use($tickets) {
// 从票据集合中随机选择一张
$winner = $tickets->random();
// 将票据ID分配给奖品
$prize->ticket_winner_id = $winner->id;
// 尝试从剩余票据中移除已分配的票据
// 预期：$tickets 集合会变小
$tickets = $tickets->except($winner->id);
});
// 此时，如果检查 $prizes 中分配的 ticket_winner_id，可能会发现重复
// 并且 $tickets 集合的大小并未改变在上述代码执行完毕后，我们可能会发现 Prize 实例的 ticket_winner_id 属性存在重复，并且 $tickets 集合的原始大小并未改变。这表明在 each 闭包内部对 $tickets 的操作并没有影响到外部的 $tickets 变量。
深入理解 PHP 闭包与变量传递
这个问题根源于 PHP 闭包对 use() 关键字所引入的外部变量的处理方式。默认情况下，当通过 use($variable) 将一个变量引入闭包时，PHP 会对该变量进行按值传递。这意味着闭包内部会得到该变量的一个副本，任何对这个副本的修改都不会影响到闭包外部的原始变量。
立即学习“PHP免费学习笔记（深入）”；
在上面的例子中：
- 当 each 方法开始执行时，$tickets 集合被按值传递给了闭包。
- 闭包内部的 $tickets 实际上是外部 $tickets 集合的一个独立副本。
- $winner = $tickets->random(); 操作的是这个副本。
- $tickets = $tickets->except($winner->id); 这行代码创建了一个新的集合实例（移除了指定 ID 的元素），并将其赋值给了闭包内部的 $tickets 副本。
- 这个赋值操作仅限于闭包的局部作用域，外部的原始 $tickets 变量对此一无所知，它仍然保持着初始的状态。
因此，每次迭代时，闭包总是操作着 $tickets 集合的原始副本，导致 random() 方法可能会反复选中相同的票据，而 except() 操作的“移除”效果也仅在闭包内部短暂生效。
解决方案：使用引用传递
要解决这个问题，我们需要确保闭包内部对 $tickets 变量的修改能够直接作用于外部的原始 $tickets 变量。这可以通过按引用传递变量来实现，即在 use() 关键字中使用 & 符号。
当使用 use(&$variable) 时，闭包内部的 $variable 不再是原始变量的副本，而是原始变量本身的一个引用（别名）。这意味着对闭包内部 $variable 的任何修改都会直接反映到闭包外部的原始变量上。
以下是修正后的代码：
use App\Models\Prize;
use App\Models\Ticket;
use Illuminate\Support\Collection;
// 假设 Prize 和 Ticket 模型已存在且包含数据
$prizes = Prize::all()->take(5);
$tickets = Ticket::all()->take(5);
// 遍历奖品集合，分配唯一票据
// 注意 use(&$tickets) 中的 & 符号
$prizes->each(function ($prize, $key) use(&$tickets) {
// 检查票据集合是否为空，避免在无票据时调用 random() 导致错误
if ($tickets->isEmpty()) {
// 可以选择跳过、记录日志或抛出异常
echo "警告：票据已分配完毕，无法为所有奖品分配唯一票据。\n";
return false; // 停止 each 循环
}
// 从票据集合中随机选择一张
$winner = $tickets->random();
// 将票据ID分配给奖品
$prize->ticket_winner_id = $winner->id;
// 从剩余票据中移除已分配的票据
// 此时，由于是引用传递，$tickets 集合的原始实例会被修改
$tickets = $tickets->except($winner->id);
// 注意：这里仅修改了 Prize 模型实例的属性，尚未保存到数据库
// $prize->save(); // 如果需要立即保存到数据库，取消注释
});
// 此时，$prizes 中的每个奖品都应分配了唯一的 ticket_winner_id
// 并且 $tickets 集合的大小会相应减少通过在 use(&$tickets) 中添加 & 符号，我们告诉 PHP，$tickets 应该以引用的方式传递给闭包。这样，闭包内部对 $tickets 的所有操作（包括 except() 方法返回新集合并重新赋值给 $tickets）都将直接作用于闭包外部的原始 $tickets 集合，从而实现票据的正确移除和唯一分配。
注意事项与最佳实践
-
数据持久化： 上述代码仅仅修改了 Prize 模型实例在内存中的 ticket_winner_id 属性。如果需要将这些更改持久化到数据库，务必在 each 循环内部或循环结束后调用 $prize->save() 方法。例如：
$prizes->each(function ($prize, $key) use(&$tickets) { // ... 分配逻辑 ... $prize->ticket_winner_id = $winner->id; $prize->save(); // 保存更改到数据库 $tickets = $tickets->except($winner->id); }); 空集合处理： 在随机选择票据之前，务必检查 $tickets 集合是否为空。如果 $tickets 集合中的元素数量少于 $prizes 集合，$tickets->random() 在集合为空时会抛出错误。添加 if ($tickets->isEmpty()) 判断可以有效避免此类运行时错误。
引用传递的适用场景： 引用传递在需要闭包直接修改外部状态时非常有用。但过度使用引用传递可能会使代码变得难以理解和维护，因为它引入了“副作用”，即函数或闭包会改变其外部的环境。在某些情况下，如果目标是转换集合而不是修改外部集合，使用 map()、filter() 或 reduce() 等函数式编程方法可能更为合适，它们通常返回新的集合实例，避免了对原始数据的直接修改。然而，对于本例中“消耗”集合元素的需求，引用传递是最直接有效的方案。
Laravel take() 与 limit()： 在 Eloquent 查询构建器中，推荐使用 take(N) 方法来限制查询结果的数量，而不是 limit(N)。虽然它们在功能上相似，但 take() 更符合 Eloquent 的链式调用习惯。
总结
在 Laravel Collection::each 方法中，当需要在闭包内部修改外部变量（特别是集合）时，理解 PHP 闭包的变量传递机制至关重要。默认的按值传递会导致对副本的修改，而无法影响原始变量。通过在 use() 关键字中使用 & 符号进行按引用传递，我们可以确保闭包能够直接操作并修改外部的原始变量，从而实现复杂的业务逻辑，例如本例中为每个奖品分配唯一票据的需求。正确地运用引用传递，能够帮助我们编写出更精确、更符合预期的代码。
