本文详解如何避免将子数组元素错误提升至顶层，通过正确的数组赋值方式构建深层嵌套结构，确保 json_encode() 输出符合 API 接口规范的 JSON 对象（如 addresseeList 包含对象数组而非扁平化字段）。
本文详解如何避免将子数组元素错误提升至顶层，通过正确的数组赋值方式构建深层嵌套结构，确保 `json_encode()` 输出符合 api 接口规范的 json 对象（如 `addresseelist` 包含对象数组而非扁平化字段）。
在 PHP 中构建嵌套 JSON 数据时，一个常见误区是误用变量赋值语法，导致本应位于子层级的键值被意外写入顶层数组。例如，原意是让 addresseeList 成为一个包含关联数组的索引数组（即 [{"mobile":"1111","correlationLabel":"corelation ejemplo"}]），但若写作：
$data['addresseeList'] = array(
$data['mobile'] = '1111', // ❌ 错误：此行同时给 $data['mobile'] 赋值并返回字符串 '1111'
$data['correlationLabel'] = 'corelation ejemplo' // ❌ 同样将字段注入 $data 根级
);这会导致 $data 中意外多出 'mobile' 和 'correlationLabel' 两个顶层键，且 addresseeList 变为索引数组 ['1111', 'corelation ejemplo']——最终 json_encode() 输出完全失真。
✅ 正确做法是：始终将子结构作为独立关联数组创建，并使用 [] 追加到目标键下：
$data = [];
$data['country'] = '+57';
$data['message'] = 'test';
$data['messageFormat'] = 0;
$data['addresseeList'][] = [ // 使用 [] 自动追加新元素（等价于 array_push($data['addresseeList'], [...])）
'mobile' => '1111',
'correlationLabel' => 'corelation ejemplo'
];
// 验证输出
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);输出结果为：
立即学习“PHP免费学习笔记（深入）”；
{
"country": "+57",
"message": "test",
"messageFormat": 0,
"addresseeList": [
{
"mobile": "1111",
"correlationLabel": "corelation ejemplo"
}
]
}⚠️ 关键注意事项：
-
切勿在数组定义中混用
$data[xxx] = yyy表达式：它会修改外部数组，破坏嵌套逻辑； -
优先使用短数组语法
[]：简洁且语义清晰，避免array()的冗余； - 若需添加多个收件人，可重复调用
$data['addresseeList'][] = [...]； - 如需严格校验结构，建议在
json_encode()前使用is_array()和isset()检查关键嵌套层级。
掌握这一模式，即可稳定生成符合 RESTful API 要求的深层嵌套 JSON，避免因数组构造错误引发的接口解析失败问题。
