本文详解如何在 php 循环中正确构建嵌套对象数组，避免因多次追加导致数据扁平化；核心是每次迭代只向结果数组添加一个包含全部字段的关联数组，而非多个独立单字段数组。
本文详解如何在 php 循环中正确构建嵌套对象数组，避免因多次追加导致数据扁平化；核心是每次迭代只向结果数组添加一个包含全部字段的关联数组，而非多个独立单字段数组。
在处理集合数据（如 ORM 模型列表）并需将其转换为结构化 JSON 响应时，一个常见误区是：在 foreach 中对同一 $result 数组多次使用 $result[] = [...] 追加多个单键数组。这会导致每个属性被拆分为独立对象，最终输出扁平、错位的数组结构——正如问题中所示：id 和 media_type 被分隔在不同数组元素中，而非成对归属同一对象。
正确的做法是：每次迭代仅创建并追加一个完整关联数组，将所有相关字段一次性组合进去。以下是修正后的标准写法：
$result = [];
foreach ($items as $item) {
$result[] = [
'id' => $item->get_id(),
'media_type' => $item->get_media_type(),
// 可继续添加其他字段，如：
// 'title' => $item->get_title(),
// 'created_at' => $item->get_created_at()->format('c'),
];
}执行后，$result 将严格生成目标结构：
[
{ "id": "17992874035441353", "media_type": "CAROUSEL_ALBUM" },
{ "id": "17842233125750202", "media_type": "IMAGE" }
]✅ 关键要点总结：
- ❌ 错误模式：$result[] = ['id' => ...]; + $result[] = ['media_type' => ...]; → 每次都新增一个数组元素；
- ✅ 正确模式：$result[] = ['id' => ..., 'media_type' => ...]; → 每次新增一个含多键的数组元素；
- ? 若需动态键名或条件字段，可先初始化空数组再赋值：
$entry = []; $entry['id'] = $item->get_id(); if ($item->hasMediaType()) { $entry['media_type'] = $item->get_media_type(); } $result[] = $entry; - ? 验证输出时，推荐使用 json_encode($result, JSON_PRETTY_PRINT) 替代 var_dump()，更直观比对 JSON 结构。
该模式是构建 API 响应、序列化模型集合的基础实践，掌握它能显著提升数据组装的准确性与可维护性。
