PHP生成三层嵌套JSON结构详解

本文深入解析了在 PHP 中构建 site → user_plants → plant_images 三层嵌套 JSON 结构的关键技巧与常见陷阱，重点揭示了因错误使用 foreach 和数组追加方式（如直接 `$row_array['user_plants'][]['plant_images'][] = $item`）导致的层级错位问题，并通过逐层构造、临时数组容器和显式初始化等核心策略，配合预处理语句防注入、类型强制转换、空数组安全声明等最佳实践，手把手教你生成结构严谨、安全可靠、易于前端消费的嵌套 JSON 数据——无论你是调试多对多关联接口还是优化 API 响应结构，这都是一份直击痛点的实战指南。

本文详解如何通过优化 foreach 循环与临时数组变量，正确构建 site → user_plants → plant_images 的三层嵌套数组结构，避免层级错位，生成符合预期的 JSON 格式。

本文详解如何通过优化 foreach 循环与临时数组变量，正确构建 site → user_plants → plant_images 的三层嵌套数组结构，避免层级错位，生成符合预期的 JSON 格式。

在 PHP 中处理多层关联数据（如站点、用户植物、植物图片）时，常见的陷阱是在错误的作用域内追加子数组，导致 plant_images 被错误地附加到 user_plants 的同级而非其子项中。原始代码中 foreach ($plant_images as $item) { $row_array['user_plants'][]['plant_images'][] = $item; } 这一行正是问题根源：它每次都在 user_plants 末尾新建一个空数组并写入 plant_images，而非向已存在的某个 user_plant 子项中添加。

✅ 正确做法：逐层构造 + 临时容器

核心思路是：为每一层“中间对象”创建独立的临时数组变量，完成该层级所有字段（含其子数组）的组装后，再整体推入上一层。具体到本例：

• 外层循环处理 sites → 构造 $site_array
• 中层循环处理 user_plants → 为每个 $user_plant 创建 $user_plant_array = (array)$user_plant
• 内层查询 plant_images → 将结果逐个追加至 $user_plant_array['plant_images'][]
• 最终将完整 $user_plant_array 推入 $site_array['user_plants'][]

这样确保了 plant_images 始终作为 user_plant 的子键存在，结构严格对齐目标 JSON。

✅ 优化后的关键代码段（含安全提示）

$json_response = [];
if ($result->num_rows > 0) {
    while ($site = $result->fetch_object()) {
        $sites[] = $site;
    }

    foreach ($sites as $site) {
        $site_array = (array)$site;
        $site_array['user_plants'] = []; // 显式初始化，避免未定义索引警告
        $site_id = $site->site_id;

        // ✅ 使用预处理语句替代拼接！此处仅展示逻辑结构
        $user_plants_query = "SELECT A.user_plant_id, A.site_id, A.plant_id 
                              FROM user_plants A 
                              RIGHT JOIN sites B ON A.site_id = ? 
                              JOIN plants C ON A.plant_id = C.plant_id 
                              GROUP BY A.user_plant_id";
        $stmt = $this->conn->prepare($user_plants_query);
        $stmt->bind_param("i", $site_id);
        $stmt->execute();
        $resultSet = $stmt->get_result();

        if ($resultSet->num_rows > 0) {
            $user_plants = $resultSet->fetch_all(MYSQLI_ASSOC);

            foreach ($user_plants as $user_plant) {
                // ? 关键：为当前 user_plant 创建独立容器
                $user_plant_array = $user_plant;
                $user_plant_array['plant_images'] = []; // 初始化子数组

                $plant_id = (int)$user_plant['plant_id'];
                $user_plant_id = (int)$user_plant['user_plant_id'];

                // 同样建议使用预处理防止 SQL 注入
                $images_query = "SELECT A.plant_image_id FROM plants_images A WHERE A.plant_id = ? 
                                 UNION 
                                 SELECT B.plant_image_id FROM user_plant_image B 
                                 JOIN user_plants C ON B.user_plant_id = ? 
                                 WHERE C.user_id = ? 
                                 GROUP BY B.plant_image_id ORDER BY plant_image_id";
                $img_stmt = $this->conn->prepare($images_query);
                $img_stmt->bind_param("iii", $plant_id, $user_plant_id, $user_id);
                $img_stmt->execute();
                $img_result = $img_stmt->get_result();

                if ($img_result->num_rows > 0) {
                    $plant_images = $img_result->fetch_all(MYSQLI_ASSOC);
                    $user_plant_array['plant_images'] = $plant_images;
                }
                // ✅ 不需要 else 分支：'plant_images' 已初始化为空数组

                $site_array['user_plants'][] = $user_plant_array;
            }
        }

        $json_response[] = $site_array;
    }
}

return $json_response;

⚠️ 重要注意事项

• SQL 注入风险：原始代码直接拼接变量（如 '" . $site_id . "'）极易被攻击。务必改用 mysqli::prepare() + bind_param() 或 PDO 预处理语句。
• 类型安全：对 ID 类整型字段强制 (int) 转换，避免意外字符串注入。
• 空数组初始化：显式声明 $user_plant_array['plant_images'] = []，避免 undefined index 警告，也使 JSON 输出更规范（空数组 [] 而非 null）。
• 资源释放：使用 mysqli_stmt::close() 或确保连接复用合理，避免内存泄漏。
• 性能考量：N+M+N×K 次查询存在 N+1 问题。生产环境建议重构为单次 JOIN 查询 + PHP 端分组（如用 site_id 和 user_plant_id 作键聚合），大幅提升效率。

通过以上结构化构造与安全加固，即可稳定输出符合要求的三层嵌套 JSON，为前端提供清晰、可预测的数据模型。

本篇关于《PHP生成三层嵌套JSON结构详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！