当前位置: 首页 > 新闻动态 > 技术教程

Laravel集合Collection怎么用_Laravel集合常用函数详解

作者:冰火之心 浏览: 发布日期:2025-12-09
[导读]:Laravel集合基于Illuminate\Support\Collection类,通过collect()创建,提供map、filter、reduce等链式方法处理数据,相比原生数组更优雅高效,常用于Eloquent结果加工。
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 集合对象,可以调用所有集合方法。

常用集合函数详解

map() - 映射转换元素

对集合中的每个元素执行回调函数,并返回新的集合。

$multiplied = collect([1, 2, 3])->map(fn($item) => $item * 2);

// 结果: [2, 4, 6]

注意:map 不保留原始键名,如需保留使用 mapWithKeys()

filter() - 过滤元素

根据回调返回 true 或 false 来筛选元素。

$even = collect([1, 2, 3, 4])->filter(fn($item) => $item % 2 === 0);

// 结果: [2, 4] (键保持不变)

最终可用 values() 重置键:

$even->values(); // [2, 4]

reduce() - 归约成单个值

将集合逐步合并为一个值,比如求和、拼接等。

$total = collect([1, 2, 3])->reduce(fn($carry, $item) => $carry + $item, 0);

// 结果: 6

carry 是累计值,初始值设为 0。

each() - 遍历集合

对每个元素执行操作,适合带副作用的逻辑(如发送邮件、记录日志)。

collect([1, 2, 3])->each(function ($item) {

echo $item;

});

与 map 不同,each 返回原集合,不生成新集合。

pluck() - 提取字段值

从数组或对象集合中提取某个字段的值。

$users = collect([

['name' => 'Alice', 'email' => 'alice@example.com'],

['name' => 'Bob', 'email' => 'bob@example.com']

]);

$names = $users->pluck('name');

// 结果: ['Alice', 'Bob']

支持嵌套字段:pluck('profile.phone')

sortBy() 和 sortByDesc() - 排序

按指定字段或回调排序。

$sorted = collect([

['name' => 'Zoe', 'age' => 25],

['name' => 'John', 'age' => 30]

])->sortBy('age');

// 按年龄升序排列

支持回调:

$sorted = $collection->sortBy(fn($person) => strlen($person['name']));

groupBy() - 分组

按字段或回调结果对元素分组。

$grouped = collect([

['product' => 'Desk', 'category' => 'Furniture'],

['product' => 'Chair', 'category' => 'Furniture'],

['product' => 'Phone', 'category' => 'Electronics']

])->groupBy('category');

// 结果: ['Furniture' => [...], 'Electronics' => [...]]

contains() - 判断是否存在

检查集合是否包含某个值或满足条件的元素。

collect([1, 2, 3])->contains(2); // true

$users->contains('name', 'Alice'); // 是否有 name 为 Alice 的用户

first() 和 last() - 获取首尾元素

获取第一个或最后一个元素,支持传入条件。

$firstEven = collect([1, 2, 3, 4])->first(fn($item) => $item % 2 === 0);

// 返回 2

也可设置默认值:

collect([])->first(fn() => true, 'default');

merge() 和 collapse() - 合并与扁平化

merge() 合并两个集合:

collect([1, 2])->merge([3, 4]); // [1, 2, 3, 4]

collapse() 将多个数组合并成一个扁平集合:

collect([[1, 2], [3, 4]])->collapse(); // [1, 2, 3, 4]

toArray() 和 toJson() - 转换格式

将集合转为数组或 JSON 字符串:

$data->toArray();

$data->toJson(); // '{"1":"value"}'

基本上就这些。Laravel 集合让数据处理变得更简洁直观,尤其适合在服务层或控制器中进行数据加工。掌握核心方法后,读写代码效率会明显提升。

免责声明:转载请注明出处:http://m.lexweb.cn/news/5998.html

扫一扫高效沟通

多一份参考总有益处

免费领取网站策划SEO优化策划方案

请填写下方表单,我们会尽快与您联系
感谢您的咨询,我们会尽快给您回复!