本文详解如何通过优化 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免费学习笔记（深入）”；
