Laravel集合Collection怎么用_Laravel集合常用函数详解_网络技术

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 集合让数据处理变得更简洁直观，尤其适合在服务层或控制器中进行数据加工。掌握核心方法后，读写代码效率会明显提升。

# php # laravel # js # json # go # 回调函数 # 工具 # ai # 排列 # red # echo # strlen # Filter # 字符串 # Collection # map # function # 对象 # default # 回调 # 链式 # 遍历 # 升序 # 你可以 # 第一个 # 多个 # 设为 # 也可 # 数据处理

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251811 】【 AI营销90571 】