告别树形数据查询噩梦：Laravelfranzose/closure-table助你轻松驾驭层级结构-composer-PHP中文网

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

WBOY

发布： 2025-07-21 13:50:13

原创

495人浏览过

可以通过一下地址学习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 安装该包非常简单：

<code class="bash">composer require franzose/closure-table</code>

登录后复制

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

<code class="php">// config/app.php

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

登录后复制

快速设置

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

<code class="bash">php artisan closuretable:make Category</code>

登录后复制

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

在 app 目录下生成两个模型：App\Category (实体模型) 和 App\CategoryClosure (闭包表模型)。
生成一个新的数据库迁移文件，用于创建 categories 和 category_closure 两张表。

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

实际应用示例

AI-Text-Classifier

OpenAI官方出品，可以区分人工智能书写的文本和人类书写的文本

查看详情

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

创建树形结构：

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

<code class="php">use App\Models\Category;

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

登录后复制

查询子节点和祖先节点：

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

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

登录后复制

获取一个节点的所有后代（包括子节点的子节点）：

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

登录后复制

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

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

登录后复制

移动节点：

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

<code class="php">$computerCategory = Category::find(5);
$mobileCategory = Category::find(2);

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

登录后复制

删除子树：

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

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

登录后复制

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

4. 实际效果与优势

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

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