when和unless是laravel集合中用于条件操作的方法。when在条件为真时执行回调,unless在条件为假时执行,二者均支持链式调用且不修改原集合。示例包括根据用户角色添加数据或过滤非活跃用户,适用于多条件组合处理,提升代码可读性与函数式编程体验。

在 Laravel 中,when 和 unless 是集合(Collection)提供的非常实用的方法,用于根据条件动态执行某些操作。它们让代码更清晰、更可读,尤其适合处理多条件逻辑下的数据处理流程。
when 方法:满足条件时执行操作
当传入的条件为 true 时,when() 方法会执行回调函数。它的第一个参数是一个布尔表达式或回调,第二个参数是满足条件时要执行的操作函数。
基本语法:
collect([...])->when($condition, function ($collection) { return $collection->someMethod(); });
示例:根据用户是否为管理员添加额外数据:
$users = collect([ ['name' => 'Alice', 'role' => 'user'], ['name' => 'Bob', 'role' => 'admin'] ]); $processed = $users->when(auth()->check() && auth()->user()->isAdmin(), function ($collection) { return $collection->push(['name' => 'System', 'role' => 'hidden']); }); // 只有当前用户是管理员时,才会添加 System 用户
unless 方法:不满足条件时执行操作
unless() 正好与 when() 相反:只有当条件为 false 时才执行回调。
适合用于“除非……否则……”的逻辑场景。
$processed = $users->unless($hideInactive, function ($collection) { return $collection->filter(fn($user) => $user['active'] ?? true); });
上面这段代码的意思是:除非 $hideInactive 为 true,否则不过滤非活跃用户。
链式调用与多个 when/unless 组合
这两个方法都返回集合本身(支持链式调用),可以组合多个条件进行复杂处理。
$result = collect($data) ->when($filters['type'] ?? null, function ($q, $value) { return $q->where('type', $value); }) ->when($sorted ?? false, function ($q) { return $q->sortBy('name'); }) ->unless($withTrashed, function ($q) { return $q->reject(fn($item) => $item['deleted']); });
说明:
-
when的回调第二个参数接收当前值(如过滤值)作为变量 -
unless常用于排除某种状态下的处理 - 所有操作都不会修改原集合,而是返回新实例
实用技巧与注意事项
使用 when 和 unless 能有效避免写一堆 if-else,使集合处理更函数式、更优雅。
建议:
- 将复杂的条件提取成变量或闭包,提高可读性
- 注意回调中必须返回集合对象,以便继续链式操作
- 可用于 Eloquent 查询构造器,其也实现了 when/unless(行为一致)
- 不要滥用嵌套,保持逻辑扁平易懂
基本上就这些。合理使用 when 和 unless,能让集合操作更简洁、条件控制更直观。不复杂但容易忽略的小技巧,值得加入日常开发习惯。


