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，能让集合操作更简洁、条件控制更直观。不复杂但容易忽略的小技巧，值得加入日常开发习惯。
