讲师中心 微信公众号
AI工具推荐 视频效率加速

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

小磊大大_3262

小磊大大_3262

发布时间:2026-10-27 15:30:00

|

207人浏览过

|

来源于php中文网

原创

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。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

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

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

11604

2023.09.01

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

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

6701

2023.10.11

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

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

2175

2023.10.11

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

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

4248

2023.10.23

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

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

4954

2023.10.23

html怎么上传
html怎么上传

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

3891

2023.11.03

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

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

5617

2023.11.09

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

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

4402

2023.11.13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

120

2026.10.22

热门下载

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

精品课程

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

共1课时 | 213人学习

PHP自制框架
PHP自制框架

共8课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn