如何在 PHP 中合并两个关联数组的特定键（如 data）并保留顶层结构

本文介绍如何将两个结构相似的 PHP 关联数组（如 API 响应）进行智能合并，仅合并其 data 子数组，同时保持 success、message 等顶层键的一致性，避免索引冲突或数据覆盖。

本文介绍如何将两个结构相似的 PHP 关联数组（如 API 响应）进行智能合并，仅合并其 data 子数组，同时保持 success、message 等顶层键的一致性，避免索引冲突或数据覆盖。

在实际开发中（尤其是处理多个微服务或分步获取的 API 响应时），常需将两个结构一致的数组（如都含 success、message、data、http_response 等键）进行融合——但并非简单使用 array_merge() 全量合并（会导致顶层键被后数组覆盖），而是精准合并嵌套的 data 数组，使最终结果中 data 包含两方字段（如 email 和 name），其余顶层字段取任一源（通常以第一个为准，或按业务逻辑校验一致性）。

推荐做法是：提取两个数组的 data 部分，用 array_merge() 合并（注意：array_merge() 对关联数组会按键名合并，相同键后者覆盖前者；若需深度合并或避免覆盖，应改用 array_replace_recursive()），再重新赋值回目标数组。

以下是可直接运行的示例代码：

// 模拟原始数组
$array1 = [
    'success'     => 1,
    'message'     => 'success',
    'status_code' => 0,
    'data'        => ['email' => '<a class="__cf_email__" data-cfemail="91fff0f4f4fcfcf0fdf8faa1a2a7d1f6fcf0f8fdbff2fefc" href="/cdn-cgi/l/email-protection">[email protected]</a>'],
    'http_response' => 200
];

$array2 = [
    'success'     => 1,
    'message'     => 'success',
    'status_code' => 0,
    'data'        => ['name' => 'ram'],
    'http_response' => 200
];

// ✅ 安全合并：仅合并 data 子数组，保留 array1 的顶层结构
$result = $array1;
$result['data'] = array_merge($array1['data'], $array2['data']);

print_r($result);

输出结果符合预期：

Array
(
    [success] => 1
    [message] => success
    [status_code] => 0
    [data] => Array
        (
            [email] => <a class="__cf_email__" data-cfemail="91fff0f4f4fcfcf0fdf8faa1a2a7d1f6fcf0f8fdbff2fefc" href="/cdn-cgi/l/email-protection">[email protected]</a>
            [name] => ram
        )
    [http_response] => 200
)

⚠️ 注意事项：

• 若两个 data 数组存在同名键（如都含 ['id']），array_merge() 会以后者值为准；如需保留前者或做自定义逻辑（如去重、追加），应改用循环合并或 array_replace_recursive()。
• 建议在合并前校验顶层关键字段（如 success、status_code）是否一致，避免错误响应被静默合并。
• 若需深度合并多层嵌套结构（如 data.user.profile），请使用 array_replace_recursive() 替代 array_merge()。

此方法简洁、高效，适用于绝大多数 RESTful 响应聚合场景。