Laravel集合基于Illuminate\Support\Collection类,通过collect()创建,提供map、filter、reduce等链式方法处理数据,相比原生数组更优雅高效,常用于Eloquent结果加工。

Laravel 的集合(Collection)是处理数组数据的强大工具,它基于 Illuminate\Support\Collection 类实现,提供了丰富的方法来操作数组或可遍历的数据。相比原生 PHP 数组函数,集合语法更优雅、链式调用更清晰,广泛用于 Eloquent 查询结果的后续处理。
你可以通过 collect() 辅助函数创建一个集合:
$data = collect([1, 2, 3, 4, 5]);
这个 $data 就是一个 Laravel 集合对象,可以调用所有集合方法。
对集合中的每个元素执行回调函数,并返回新的集合。
$multiplied = collect([1, 2, 3])->map(fn($item) => $item * 2);
// 结果: [2, 4, 6]
注意:map 不保留原始键名,如需保留使用 mapWithKeys()。
根据回调返回 true 或 false 来筛选元素。
$even = collect([1, 2, 3, 4])->filter(fn($item) => $item % 2 === 0);
// 结果: [2, 4] (键保持不变)
最终可用 values() 重置键:
$even->values(); // [2, 4]
将集合逐步合并为一个值,比如求和、拼接等。
$total = collect([1, 2, 3])->reduce(fn($carry, $item) => $carry + $item, 0);
// 结果: 6
carry 是累计值,初始值设为 0。
对每个元素执行操作,适合带副作用的逻辑(如发送邮件、记录日志)。
collect([1, 2, 3])->each(function ($item) {
echo $item;
});
与 map 不同,each 返回原集合,不生成新集合。
从数组或对象集合中提取某个字段的值。
$users = collect([
['name' => 'Alice', 'email' => 'alice@example.com'],
['name' => 'Bob', 'email' => 'bob@example.com']
]);
$names = $users->pluck('name');
// 结果: ['Alice', 'Bob']
支持嵌套字段:pluck('profile.phone')
按指定字段或回调排序。
$sorted = collect([
['name' => 'Zoe', 'age' => 25],
['name' => 'John', 'age' => 30]
])->sortBy('age');
// 按年龄升序排列
支持回调:
$sorted = $collection->sortBy(fn($person) => strlen($person['name']));
按字段或回调结果对元素分组。
$grouped = collect([
['product' => 'Desk', 'category' => 'Furniture'],
['product' => 'Chair', 'category' => 'Furniture'],
['product' => 'Phone', 'category' => 'Electronics']
])->groupBy('category');
// 结果: ['Furniture' => [...], 'Electronics' => [...]]
检查集合是否包含某个值或满足条件的元素。
collect([1, 2, 3])->contains(2); // true
$users->contains('name', 'Alice'); // 是否有 name 为 Alice 的用户
获取第一个或最后一个元素,支持传入条件。
$firstEven = collect([1, 2, 3, 4])->first(fn($item) => $item % 2 === 0);
// 返回 2
也可设置默认值:
collect([])->first(fn() => true, 'default');
merge() 合并两个集合:
collect([1, 2])->merge([3, 4]); // [1, 2, 3, 4]
collapse() 将多个数组合并成一个扁平集合:
collect([[1, 2], [3, 4]])->collapse(); // [1, 2, 3, 4]
将集合转为数组或 JSON 字符串:
$data->toArray();
$data->toJson(); // '{"1":"value"}'
基本上就这些。Laravel 集合让数据处理变得更简洁直观,尤其适合在服务层或控制器中进行数据加工。掌握核心方法后,读写代码效率会明显提升。
以上就是Laravel集合Collection怎么用_Laravel集合常用函数详解的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号