本文介绍如何在 laravel 中使用 collection 的 map() 和 firstwhere() 方法，基于主键（如 id 与 reference）将第二个集合中的 quantity 值安全累加到第一个集合对应项中，实现高效、可读性强的集合合并操作。
本文介绍如何在 laravel 中使用 collection 的 map() 和 firstwhere() 方法，基于主键（如 id 与 reference）将第二个集合中的 quantity 值安全累加到第一个集合对应项中，实现高效、可读性强的集合合并操作。
在 Laravel 开发中，常需对两个 Collection 进行关联更新（例如库存叠加、销量汇总等），而无需借助数据库查询。核心思路是：遍历主集合（如商品列表），对每一项查找辅助集合中匹配 reference（对应主集合的 id）的记录，并将其 quantity 累加至主项的 quantity 字段。
以下为完整、健壮的实现方案：
// 示例数据（注意：实际项目中通常来自 Eloquent 查询或 API 响应）
$products = collect([
['id' => 1, 'name' => 'product x', 'quantity' => 100],
['id' => 2, 'codProd' => 'product y', 'quantity' => 200],
['id' => 3, 'name' => 'product a.', 'quantity' => 30],
]);
$adjustments = collect([
['reference' => 1, 'quantity' => 80],
['reference' => 2, 'quantity' => 50],
]);
// 关键逻辑：map + firstWhere 实现关联累加
$result = $products->map(function ($product) use ($adjustments) {
// 查找 adjustment 中 reference 匹配 product.id 的项
$adjustment = $adjustments->firstWhere('reference', $product['id']);
// 若找到，则累加 quantity（自动类型转换，支持整数/字符串）
if ($adjustment) {
$product['quantity'] = (int)$product['quantity'] + (int)$adjustment['quantity'];
}
return $product;
})->values(); // ->values() 可选，用于重置索引（避免空洞索引）
// 输出结果
dd($result->toArray());
✅ 输出效果：
Laravel 13.2.0
下载
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
[
{"id":1,"name":"product x","quantity":180},
{"id":2,"codProd":"product y","quantity":250},
{"id":3,"name":"product a.","quantity":30}
]
? 注意事项与最佳实践：
- firstWhere('reference', $product['id']) 是 Laravel Collection 提供的高效查找方式，比 filter()->first() 更简洁且性能更优；
- 显式转换 (int) 可规避字符串拼接风险（如 "100" + "80" → "10080"），确保数值正确相加；
- 若 quantity 字段可能为空或非数字，建议增加 is_numeric() 校验或使用 filter()->sum() 替代直接访问；
- 如需批量高性能处理（万级数据），可预先构建 $adjustmentMap = $adjustments->pluck('quantity', 'reference')，再通过 $adjustmentMap->get($product['id'], 0) 查找，时间复杂度从 O(n×m) 降至 O(n+m)；
- 此方案完全内存操作，不依赖数据库，适用于 API 响应聚合、报表计算等场景。
该方法简洁、语义清晰，是 Laravel Collection 函数式编程的典型应用，兼顾可维护性与执行效率。
