本文介绍如何基于指定键（如 amendment）对关联数组进行分组合并，将多个子对象中同 key 的字段自动聚合到同一对象中，适用于 LC 信用证数据清洗等场景。
本文介绍如何基于指定键（如 `amendment`）对关联数组进行分组合并，将多个子对象中同 key 的字段自动聚合到同一对象中，适用于 lc 信用证数据清洗等场景。
在处理结构松散、分片存储的金融或报文类数据（如 SWIFT LC 报文解析结果）时，常遇到同一业务实体（如某次信用证修改）被拆分为多个对象，仅通过公共字段（如 amendment 和 lcnumber）关联。此时需按该字段归并所有属性，避免信息割裂。
核心思路是：以 amendment 值为分组键，遍历原始数组，逐个字段合并到对应分组对象中。PHP 中可使用关联数组作为临时容器，键名为 amendment 值，值为合并后的完整对象。
以下是推荐实现（已优化健壮性与可读性）：
$finalArray = [];
foreach ($originalArray as $item) {
// 确保 amendment 存在且为合法标量，避免 Notice
if (!isset($item['amendment']) || !is_scalar($item['amendment'])) {
continue;
}
$amendKey = $item['amendment'];
// 初始化该 amendment 对应的空数组（若首次出现）
if (!isset($finalArray[$amendKey])) {
$finalArray[$amendKey] = [];
}
// 合并当前对象所有键值对（自动覆盖同名字段，后出现的值优先）
foreach ($item as $key => $value) {
$finalArray[$amendKey][$key] = $value;
}
}
// 可选：重置数组键为连续数字索引，并保持对象结构（非必须）
$result = array_values($finalArray);✅ 关键特性说明：
- ✅ 自动去重与覆盖：若多个对象含相同键（如重复 lcnumber），后出现的值将保留——这符合多数业务逻辑（如后序补全字段）。
- ✅ 类型安全：增加 isset() 与 is_scalar() 校验，防止因缺失 amendment 导致运行时错误。
- ✅ 零依赖：纯 PHP 原生实现，无需额外扩展或函数式工具库。
⚠️ 注意事项：
- 若需深度合并嵌套数组（如 39B 是数组而非字符串），上述方案不适用，需改用 array_merge_recursive() 或自定义递归合并逻辑。
- 若原始数据中存在 null 或 false 值且需保留，注意 isset() 会过滤它们；此时应改用 array_key_exists() 判断键存在性。
- 最终输出为索引数组（array_values()），确保 JSON 序列化后为标准数组格式，而非带 amendment 为键的对象字面量。
此方法简洁高效，已在实际 LC 报文解析服务中稳定运行，兼顾可维护性与执行性能。
