在开发一个 laravel 项目时，我遇到了一个棘手的问题：需要在数据库中处理复杂的树形和图形结构。传统的 eloquent 关系无法满足我的需求，因为它们不支持递归查询。这导致我在处理分类、评论系统和组织结构等场景时遇到了效率低下的问题。经过一番研究，我找到了 staudenmeir/laravel-adjacency-list 这个库，它利用 cte（common table expressions）来实现递归关系，彻底解决了我的困扰。
首先，我通过 composer 安装了这个库：
composer require staudenmeir/laravel-adjacency-list:"^1.0"
安装完成后，我在模型中使用了 HasRecursiveRelationships 或 HasGraphRelationships trait，这取决于我处理的是树形结构还是图形结构。对于树形结构，我定义了一个简单的用户模型：
class User extends Model { use StaudenmeirLaravelAdjacencyListEloquentHasRecursiveRelationships; public function getParentKeyName() { return 'parent_id'; } }
有了这个库，我可以轻松地查询用户的祖先、后代、兄弟姐妹等关系。例如，获取一个用户的所有后代：
$descendants = User::find($id)->descendants;
对于图形结构，我定义了一个节点模型：
class Node extends Model { use StaudenmeirLaravelAdjacencyListEloquentHasGraphRelationships; public function getPivotTableName(): string { return 'edges'; } }
这允许我处理具有多个父节点的复杂图形结构，例如获取一个节点的所有后代：
$descendants = Node::find($id)->descendants;
使用这个库，我不仅可以轻松地处理递归关系，还可以利用其提供的各种查询范围和方法来优化查询。例如，我可以使用 tree() 范围来获取整个树结构，或者使用 subgraph() 范围来获取图形的子图。此外，我还可以使用 breadthFirst() 和 depthFirst() 来控制遍历顺序，以及使用 wheredepth() 来限制查询深度。
这个库的优势在于它支持多种数据库，包括 mysql、postgresql、sqlite 等，并且提供了丰富的 API 来处理复杂的递归关系。通过使用 staudenmeir/laravel-adjacency-list，我不仅解决了递归查询的问题，还显著提高了程序的性能和可维护性。
总的来说，staudenmeir/laravel-adjacency-list 是一个强大且易用的工具，极大地简化了我在 Laravel 项目中处理树形和图形结构的复杂度。如果你也面临类似的挑战，我强烈推荐你尝试这个库。
