[分享]Laravel each() 循环内如何构建数组并获取最终结果？

Laravel 中 each() 方法与数组构建：如何获取最终结果？

在 Laravel 开发中，我们常常使用 each() 方法遍历集合并执行特定操作。然而，当你尝试在 each() 方法的闭包内构建数组，并在外部访问最终结果时，可能会遇到问题。本文将深入剖析这一问题，并提供两种有效的解决方案。

问题解析：闭包作用域的影响

考虑以下场景：你希望获取特定用户的所有权限，这些权限存储在关联表中。你可能会写出如下代码：

$user = User::with('roles.perms')->find(1);

$permissions = [];

$user->roles->each(function ($role) use ($permissions) {
    $permissions = array_merge($permissions, $role->perms->toArray());
});

dd($permissions); // 预期结果：包含所有权限的数组，实际结果：空数组

你可能会惊讶地发现，$permissions 变量在 dd() 函数中打印出来是空的。这是因为 each() 方法的闭包函数拥有独立的作用域。尽管我们使用 use ($permissions) 将外部变量传递给了闭包，但这仅仅是值传递，而非引用传递。因此，在闭包内部对 $permissions 变量进行的修改并不会影响到外部的同名变量。

解决方案一： map() 方法的优雅应用

针对上述问题，map() 方法提供了一种更简洁、更易于理解的解决方案。map() 方法会遍历集合中的每个元素，并对其应用指定的回调函数，最终返回一个包含所有处理结果的新集合。

以下代码展示了如何使用 map() 方法获取用户的所有权限：

$user = User::with('roles.perms')->find(1);

$permissions = $user->roles->map(function ($role) {
    return $role->perms->toArray();
})->flatten()->all();

dd($permissions); // 正确输出：包含所有权限的数组

这段代码的执行过程如下：

1. map() 方法遍历 $user->roles 集合，对每个 $role 应用回调函数。

2. 回调函数将每个 $role 关联的 perms 转换为数组并返回。

3. flatten() 方法将嵌套的数组扁平化为一个单层数组。

4. all() 方法将集合转换为普通的 PHP 数组，存储在 $permissions 变量中。

通过使用 map() 方法，我们无需担心闭包作用域的问题，代码逻辑也更加清晰易懂。

解决方案二： 引用传递的妙用

如果你坚持使用 each() 方法，可以通过引用传递 $permissions 变量来解决问题。

修改后的代码如下：

$user = User::with('roles.perms')->find(1);

$permissions = [];

$user->roles->each(function ($role) use (&$permissions) {
    $permissions = array_merge($permissions, $role->perms->toArray());
});

dd($permissions); // 正确输出：包含所有权限的数组

关键在于 use (&$permissions) 部分。通过在 $permissions 前面添加 & 符号，我们将其作为引用传递给闭包。这意味着在闭包内部对 $permissions 进行的任何修改都会直接影响到外部的同名变量。

总结

在 Laravel 中操作集合时，理解闭包作用域至关重要。对于构建数组的需求，map() 方法通常是更优的选择，因为它代码简洁、逻辑清晰。如果你必须使用 each() 方法，务必使用引用传递来修改外部变量。

常见问题解答

1. 为什么我不能直接在 each() 方法的闭包内返回结果？

   each() 方法主要用于遍历集合并执行操作，它并不返回值。如果你需要根据集合元素生成新的数组，应该使用 map() 方法。

2. 除了 map() 方法，还有哪些方法可以用于构建数组？

   除了 map() 方法，你还可以使用 reduce()、flatMap() 等方法根据需求构建数组。

3. 引用传递和值传递有什么区别？

   值传递将变量的副本传递给函数或闭包，对副本的修改不会影响原始变量。引用传递则传递变量的内存地址，函数或闭包可以直接操作原始变量。

4. 使用 map() 方法和引用传递哪种方法效率更高？

   一般来说，map() 方法的效率更高，因为它直接返回新的集合，而引用传递需要修改外部变量。

5. 如何选择合适的集合操作方法？

   选择合适的集合操作方法取决于你的具体需求。例如，需要遍历集合并执行操作时，可以选择 each() 方法；需要根据集合元素生成新的数组时，可以选择 map() 方法。