Laravel11.x无限级分类接口怎么返回树形JSON

小磊大大_3262

小磊大大_3262

2026-10-27

207人浏览

原创

Laravel 11 中推荐用自关联模型+内存递归构建无限级分类树:定义 children/parent 关系,预加载后通过 buildTree 方法转为 JSON 树结构,并用 keyBy 优化性能。

laravel11.x无限级分类接口怎么返回树形json

在 Laravel 11.x 中实现无限级分类并返回树形 JSON,核心是利用模型的「父子关系」+ 「递归构建」,推荐使用 Eloquent 的嵌套集合(Nested Set)或自关联(Self-Relationship)两种方式。对大多数业务场景(如文章分类、商品类目),**自关联 + 递归转数组**更轻量、易维护,且兼容性好。

✅ 使用自关联模型 + 递归构造树结构

假设分类表 categories 包含字段:id、name、parent_id(为 null 表示顶级)。

1. 定义模型关系(app/Models/Category.php):

注意:Laravel 11 默认启用强制类型和严格模式,确保 parent_id 允许 null(数据库字段设为 nullable)

  • 添加 children() 关系(一对多)
  • 添加 parent() 关系(一对一,用于反查)

```php
class Category extends Model
{
  protected $fillable = ['name', 'parent_id'];

  public function children()
  {
    return $this->hasMany(Category::class, 'parent_id');
  }

  public function parent()
  {
    return $this->belongsTo(Category::class, 'parent_id');
  }
}

✅ 控制器中构建并返回树形 JSON

不建议在视图或响应中实时递归查询(N+1 问题),应先获取全部分类,再内存中构建树。

在控制器方法中(例如 CategoryController@index):

JS X Monitor
JS X Monitor

X.com (Twitter) 账号监控自动化:定时抓取指定账号最新推文,发现新内容即时推送通知。

下载
  • 用 with('children') 预加载所有子项(一层深度)
  • 通过 whereNull('parent_id') 获取所有根节点
  • 编写辅助方法 buildTree($categories) 递归扁平转树

示例代码片段:

```php
public function index()
{
  $all = Category::with('children')->get();
  $roots = $all->whereNull('parent_id');
  $tree = $this->buildTree($roots, $all);
  return response()->json($tree);
}

protected function buildTree($nodes, $all)
{
  return $nodes->map(function ($node) use ($all) {
    $children = $all->where('parent_id', $node->id);
    return $node->merge([
      'children' => $this->buildTree($children, $all)
    ]);
  })->values();
}

✅ 优化:避免重复遍历,用 ID 建索引提升性能

当分类数量较大(如 >500 条)时,上述 $all->where(...) 会多次遍历集合。可提前构建哈希映射:

  • 用 $map = $all->keyBy('id') 构建 ID → 模型映射
  • 递归时用 $map->get($parentId) 快速查找,O(1)
  • 同时过滤出 children 时用 $all->filter(...) 或直接用集合操作

这样即使上千条分类,构建树也仅需毫秒级。

✅ 可选:使用 spatie/laravel-nestedset(适合深度操作)

若需频繁移动节点、获取祖先链、判断层级等,推荐安装 spatie/laravel-nestedset:

  • 自动维护 lft/rgt 字段
  • 一行代码获取整棵树:Category::defaultOrder()->get()->toTree()
  • 返回的就是已组织好的嵌套集合,直接 json_encode 即可

注意:需迁移新增字段,并在模型中 use HasNestedSets trait。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11564

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6681

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2175

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4228

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4934

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3871

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5597

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4382

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12302

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 213人学习

Composer手册
Composer手册

共0课时 | 0人学习