0

0

告别树形数据查询噩梦:Laravelfranzose/closure-table助你轻松驾驭层级结构

WBOY

WBOY

发布时间:2025-07-21 13:50:13

|

504人浏览过

|

来源于php中文网

原创

可以通过一下地址学习composer学习地址

1. 那些年,我们被树形数据折磨的“痛”

想象一下,你正在构建一个内容管理系统,其中文章分类可以有多级嵌套,比如“新闻”下有“国内新闻”和“国际新闻”,“国内新闻”下又有“时政”、“经济”等。如果仅仅使用一个 parent_id 字段来表示父子关系(典型的邻接列表模式),那么当你需要实现以下功能时,就会感到力不从心:

  • 查询某个分类下的所有子分类(包括子分类的子分类):你需要编写复杂的递归查询(例如使用 WITH RECURSIVE CTE 或多次 JOIN),随着层级的加深,查询语句变得越来越庞大,性能也直线下降。
  • 获取某个文章分类的所有祖先路径:同样需要反向递归查询,代码复杂且效率低下。
  • 移动一个分类及其所有子分类到另一个父分类下:这不仅仅是更新一个 parent_id 那么简单,可能需要手动处理大量关联数据,稍有不慎就可能导致数据混乱。
  • 统计某个分类下的所有文章数量(包括子分类的文章):如果没有高效的层级查询,这个统计将变得非常耗时。

这些问题让基于邻接列表的树形数据管理成为了许多开发者的噩梦,不仅增加了开发难度,也为未来的维护埋下了隐患。

2. 柳暗花明:Closure Table 模式的救赎

为了解决邻接列表的痛点,业界提出了多种树形数据存储模式,其中闭包表(Closure Table)模式因其高效的查询能力和相对简单的实现而备受青睐。

闭包表的核心思想是:用一个额外的辅助表(即闭包表)来存储所有节点之间的祖先-后代关系。这个辅助表通常包含 ancestor(祖先节点ID)、descendant(后代节点ID)和 depth(深度)等字段。

举个例子,如果你的分类结构是:A -> B -> C,那么闭包表中会记录以下关系:

  • (A, A, 0) - A是A的祖先,深度为0
  • (B, B, 0) - B是B的祖先,深度为0
  • (C, C, 0) - C是C的祖先,深度为0
  • (A, B, 1) - A是B的祖先,深度为1
  • (A, C, 2) - A是C的祖先,深度为2
  • (B, C, 1) - B是C的祖先,深度为1

有了这个闭包表,你想要查询节点A的所有后代,只需要简单地查询 ancestor = A 的所有 descendant 即可;想要查询节点C的所有祖先,则查询 descendant = C 的所有 ancestor。这些操作都变成了简单的 JOIN 查询,避免了复杂的递归,大大提升了查询效率。

franzose/closure-table 在此基础上,还巧妙地结合了邻接列表的优点,使得查询直接父子关系也同样高效,实现了性能与便捷性的完美平衡。

3. 拥抱 Laravel:franzose/closure-table 的魔力

在 Laravel 项目中,franzose/closure-table 包将闭包表的强大能力带到了你的 Eloquent 模型中,让复杂的树形操作变得像操作普通模型一样简单。

安装过程

通过 Composer 安装该包非常简单:

composer require franzose/closure-table

如果你使用的是 Laravel 5.5+,服务提供者会自动注册。否则,你需要手动将其添加到 config/app.phpproviders 数组中:

// config/app.php

return [
    'providers' => [
        // ...
        Franzose\ClosureTable\ClosureTableServiceProvider::class,
    ],
];

快速设置

安装完成后,你可以使用 Artisan 命令快速生成模型和迁移文件:

php artisan closuretable:make Category

这条命令会为你做几件事:

  1. app 目录下生成两个模型:App\Category (实体模型) 和 App\CategoryClosure (闭包表模型)。
  2. 生成一个新的数据库迁移文件,用于创建 categoriescategory_closure 两张表。

Category 模型会继承 Franzose\ClosureTable\Models\Entity,而 CategoryClosure 模型则继承 Franzose\ClosureTable\Models\ClosureTable,它们为你封装了所有复杂的树形操作逻辑。

实际应用示例

Removal.AI
Removal.AI

AI移出图片背景工具

下载

现在,你就可以像操作普通 Eloquent 模型一样来处理你的层级数据了:

创建树形结构:

你可以通过数组轻松创建复杂的树形结构:

use App\Models\Category;

Category::createFromArray([
    'id' => 1, 'name' => '电子产品',
    'children' => [
        [
            'id' => 2, 'name' => '手机',
            'children' => [
                ['id' => 3, 'name' => '安卓手机'],
                ['id' => 4, 'name' => '苹果手机'],
            ]
        ],
        ['id' => 5, 'name' => '电脑'],
    ]
]);

查询子节点和祖先节点:

获取一个节点的所有直接子节点:

$mobileCategory = Category::find(2);
$children = $mobileCategory->getChildren()->pluck('name')->toArray();
// 结果:['安卓手机', '苹果手机']

获取一个节点的所有后代(包括子节点的子节点):

$electronicsCategory = Category::find(1);
$descendants = $electronicsCategory->getDescendants()->pluck('name')->toArray();
// 结果:['手机', '安卓手机', '苹果手机', '电脑']

获取一个节点的所有祖先:

$androidCategory = Category::find(3);
$ancestors = $androidCategory->getAncestors()->pluck('name')->toArray();
// 结果:['电子产品', '手机']

移动节点:

将“电脑”分类移动到“手机”分类下,并指定位置:

$computerCategory = Category::find(5);
$mobileCategory = Category::find(2);

$computerCategory->moveTo(0, $mobileCategory); // 移动到手机分类下,作为第一个子节点

删除子树:

删除“手机”分类及其所有子分类:

$mobileCategory = Category::find(2);
$mobileCategory->deleteSubtree();
// 此时,ID为2、3、4的分类及其在闭包表中的所有关系都将被删除。

franzose/closure-table 还提供了更多强大的方法,例如获取兄弟节点、获取根节点、判断是否为叶子节点等,极大地简化了树形数据操作的复杂度。

4. 实际效果与优势

引入 franzose/closure-table 后,你将体验到以下显著优势:

  • 高效查询: 查询性能显著提升,尤其是在处理深层或大型树形结构时,告别了多重 JOIN 的性能瓶颈。无论是获取所有祖先还是所有后代,都只需一次简单的 JOIN 操作,极大缩短了响应时间。
  • 简化代码: 复杂的树形操作被封装成简单直观的 Eloquent 方法,如 getAncestors()getDescendants()moveTo() 等,大大减少了业务逻辑层的代码量和复杂度。你不再需要编写冗长且易错的递归查询。
  • 维护便捷: 无论是添加新节点、删除节点及其子树,还是调整整个子树的层级,都变得轻而易举,降低了维护成本和出错率。
  • Laravel 友好: 完美融入 Laravel 生态,遵循 Eloquent 风格,学习成本低,开发体验极佳。开发者可以快速上手,专注于业务逻辑而非底层数据结构。

5. 结语

如果你还在为 Laravel 项目中的树形数据管理而烦恼,还在编写复杂的递归查询,那么 franzose/closure-table 绝对值得一试。它不仅解决了传统方案的痛点,更提供了一套优雅、高效的解决方案,让你的代码更健壮、性能更卓越。

拥抱 Composer,拥抱像 franzose/closure-table 这样的优秀开源库,让你的开发之路更加顺畅,从树形数据管理的噩梦中解脱出来,享受更愉悦的编程体验!

相关专题

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

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

2512

2023.09.01

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

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

1596

2023.10.11

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

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

1487

2023.10.11

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

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

952

2023.10.23

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

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

1415

2023.10.23

html怎么上传
html怎么上传

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

1234

2023.11.03

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

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

1445

2023.11.09

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

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

1306

2023.11.13

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
第二十四期_PHP8编程
第二十四期_PHP8编程

共86课时 | 3.4万人学习

成为PHP架构师-自制PHP框架
成为PHP架构师-自制PHP框架

共28课时 | 2.4万人学习

第二十三期_PHP编程
第二十三期_PHP编程

共93课时 | 6.8万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号