本文详解如何在 laravel 中通过 eloquent 关系预加载（with）结合 foreach 循环，将分类（category）及其关联页面（pages）组织为「父级标题 + 子级 children 数组」的嵌套 json 结构，避免扁平化拼接错误。
本文详解如何在 laravel 中通过 eloquent 关系预加载（with）结合 foreach 循环，将分类（category）及其关联页面（pages）组织为「父级标题 + 子级 children 数组」的嵌套 json 结构，避免扁平化拼接错误。
在 Laravel 开发中，常需将一对多关系（如 Category → Page）转换为前端友好的树形结构数据。原始代码的问题在于：它将每个 page 作为独立数组项追加到 $data 根数组中，导致分类与页面完全平级、无层级归属，无法体现“某分类下包含哪些页面”的语义。
正确的做法是——每个分类对应一个顶层对象，其 children 键（可选）内聚该分类下的所有页面数据。以下是优化后的实现：
public function getCategory($lang): array
{
$data = [];
$categories = Category::where('language', $lang)->with('pages')->get();
foreach ($categories as $category) {
$item = [
'title' => $category->title,
'path' => $category->slug,
];
// 若存在关联页面，则构造 children 数组（强制索引重排，避免空键）
if ($category->pages->isNotEmpty()) {
$item['children'] = $category->pages->map(function ($page) {
return [
'title' => $page->title,
'path' => $page->slug,
];
})->values()->toArray();
}
$data[] = $item;
}
return $data;
}
✅ 关键改进说明：
- 使用 Laravel 集合方法 map() + values() 替代原生 array_map()，更符合 Laravel 语义，且自动重置数组键（避免因模型缓存或删除导致的非连续数字键）；
- 用 $category->pages->isNotEmpty() 替代 !empty($category['pages'])，既安全（避免访问不存在属性）又语义清晰；
- 所有字段均使用对象属性访问（$category->title），而非数组下标（$category['title']），兼容 Eloquent 属性获取逻辑与访问器（accessors）；
- children 作为分类对象的子键存在，结构清晰、层级明确，输出示例如下：
[
{
"title": "corporate",
"path": "corporate",
"children": [
{ "title": "corporatealt", "path": "corporatealt" },
{ "title": "corporatealt2", "path": "corporatealt2" }
]
},
{
"title": "blabla",
"path": "blabla"
}
]
⚠️ 注意事项：
- 确保 Category 模型已正确定义 pages 关系（如 hasMany(Page::class)），且 Page 模型中 title/slug 字段存在且可访问；
- 若需支持深层嵌套（如页面再含子项），建议改用递归资源类（JsonResource）提升可维护性；
- 对于大数据量场景，考虑添加 select() 显式指定字段，减少内存占用与序列化开销。
此方案兼顾可读性、健壮性与 Laravel 最佳实践，是构建导航菜单、侧边栏目录等层级数据的标准处理模式。
