如何将循环中分散的键值对合并为结构化对象数组

本文详解如何在 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 响应、序列化模型集合的基础实践，掌握它能显著提升数据组装的准确性与可维护性。