本文详解如何在 Laravel/PHP 中根据公共字段（如 id）高效合并两个关联数组，使用 Laravel Collections 的 map()、where() 和 first() 等链式方法实现精准匹配与字段注入，避免嵌套循环，兼顾可读性与性能。
本文详解如何在 laravel/php 中根据公共字段（如 `id`）高效合并两个关联数组，使用 laravel collections 的 `map()`、`where()` 和 `first()` 等链式方法实现精准匹配与字段注入，避免嵌套循环，兼顾可读性与性能。
在 Laravel 开发中，常需将来自不同数据源（如多个 Eloquent 查询、API 响应或手动构造的数组）的结构化数据按唯一标识符（如 id）进行横向合并。本教程以两个含 id 字段的二维数组为例，演示如何专业、安全地完成合并操作，并生成符合预期的扁平化结果。
✅ 正确的数据结构前提
首先，请确保原始数组使用标准 PHP 关联语法（而非赋值语句），例如：
$arr_1 = [
['id' => 1, 'name' => 'Foo'],
['id' => 2, 'name' => 'Bar'],
];
$arr_2 = [
['id' => 1, 'Percentage' => 60],
['id' => 2, 'Percentage' => 70],
];⚠️ 注意：原始问题中
id=1是无效 PHP 语法，必须改为'id' => 1；否则代码无法运行。
✅ 推荐方案：使用 Laravel Collections 合并（推荐用于 Laravel 项目）
将数组转为 Collection 实例后，利用其高阶方法实现声明式合并：
use Illuminate\Support\Arr;
use Illuminate\Support\Collection;
$col_1 = collect($arr_1);
$col_2 = collect($arr_2);
$result = $col_1->map(function ($item) use ($col_2) {
// 根据 id 查找 arr_2 中对应项
$match = $col_2->firstWhere('id', $item['id']);
// 合并字段：保留原 item 所有键值，并注入 Percentage
return array_merge($item, Arr::only($match, ['Percentage']));
});✅ 输出结果：
[
{"id":1,"name":"Foo","Percentage":60},
{"id":2,"name":"Bar","Percentage":70}
]✅ 替代方案：纯 PHP 实现（兼容非 Laravel 环境）
若未使用 Laravel 或需最大兼容性，可用 foreach + array_search 实现：
$result = [];
foreach ($arr_1 as $item) {
$id = $item['id'];
// 在 arr_2 中查找匹配 id 的元素
$match = null;
foreach ($arr_2 as $row) {
if ($row['id'] === $id) {
$match = $row;
break;
}
}
$result[] = $match ? array_merge($item, ['Percentage' => $match['Percentage']]) : $item;
}? 关键注意事项
-
性能提示：
$col_2->firstWhere('id', $id)时间复杂度为 O(n)，若数据量大（>1000 条），建议先用keyBy('id')构建哈希映射：$lookup = $col_2->keyBy('id'); // 转为 ['1' => [...], '2' => [...]] $result = $col_1->map(fn($i) => array_merge($i, $lookup[$i['id']] ?? [])); -
空值安全：始终假设匹配可能失败，推荐使用
?? []或Arr::get($match, 'Percentage', null)提供默认值。 -
字段冲突处理：若两数组存在同名字段（如都含
name），array_merge()会以后者覆盖前者；如需保留优先级，可显式指定键赋值。
✅ 总结
基于 id 合并数组的核心逻辑是「查找 → 关联 → 合并」。Laravel Collections 提供了简洁、函数式、可读性强的解决方案；而纯 PHP 方案则确保基础环境兼容性。无论选用哪种方式，务必校验输入结构、处理缺失匹配，并在生产环境做好性能评估。
