PHPackages                             lordsimal/laravel-trees - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. lordsimal/laravel-trees

ActiveLibrary[Utility & Helpers](/categories/utility)

lordsimal/laravel-trees
=======================

Multi-Tree structures for Laravel

0890↓27.8%PHPCI passing

Since Mar 23Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/LordSimal/laravel-trees)[ Packagist](https://packagist.org/packages/lordsimal/laravel-trees)[ RSS](/packages/lordsimal-laravel-trees/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/3bffaaf01553c97330e2aaead4ab024eb9112b2ecc09186506c2ce62cc3ec8a9/687474703a2f2f706f7365722e707567782e6f72672f6c6f726473696d616c2f6c61726176656c2d74726565732f76)](https://packagist.org/packages/lordsimal/laravel-trees)[![Total Downloads](https://camo.githubusercontent.com/f4a134c94281847117fc30e6656a98c565177c9ddb98b04db9ba6850c6413240/687474703a2f2f706f7365722e707567782e6f72672f6c6f726473696d616c2f6c61726176656c2d74726565732f646f776e6c6f616473)](https://packagist.org/packages/lordsimal/laravel-trees)[![Latest Unstable Version](https://camo.githubusercontent.com/5d3a7c9a75fc5bc696f67efba844674c79b504aad126eafa206dac3c20d1c679/687474703a2f2f706f7365722e707567782e6f72672f6c6f726473696d616c2f6c61726176656c2d74726565732f762f756e737461626c65)](https://packagist.org/packages/lordsimal/laravel-trees)[![License](https://camo.githubusercontent.com/6641aa93bb62c39a6c963afc4943b8c4b2a82d06176d3742345a91c06305ed5f/687474703a2f2f706f7365722e707567782e6f72672f6c6f726473696d616c2f6c61726176656c2d74726565732f6c6963656e7365)](https://packagist.org/packages/lordsimal/laravel-trees)[![PHP Version Require](https://camo.githubusercontent.com/161b3108325a65a54e68287fd21e6ba363afe0d8544ce26911cac5623e252007/687474703a2f2f706f7365722e707567782e6f72672f6c6f726473696d616c2f6c61726176656c2d74726565732f726571756972652f706870)](https://packagist.org/packages/lordsimal/laravel-trees)[![codecov](https://camo.githubusercontent.com/0b881c3141dd88cf39919e821712b4648b89e4d7283d2cbc4685feddbb51af04/68747470733a2f2f636f6465636f762e696f2f67682f4c6f726453696d616c2f6c61726176656c2d74726565732f67726170682f62616467652e7376673f746f6b656e3d684356554a7952623344)](https://codecov.io/gh/LordSimal/laravel-trees)

Laravel Trees
=============

[](#laravel-trees)

**Contents:**

- [Theory](#information)
- [Installation](#installation)
- [Documentation](#documentation)
    - [Basic](docs/Basic.md)
    - [AdvancedTreeConfig](docs/AdvancedTreeConfig.md)
    - [Migration](docs/Migration.md)
    - [Creating Nodes](docs/CreatingNodes.md)
    - [Managing Nodes](docs/ManagingNodes.md)
    - [Receiving Nodes](docs/ReceivingNodes.md)
    - [Model's Helpers](docs/Helpers.md)
    - [Console](docs/Console.md)
    - [Health And Fixing.md](docs/HealthAndFix.md)

Information
-----------

[](#information)

This package allows to have a single root or multi root tree structure in your Laravel application.

### What are nested sets?

[](#what-are-nested-sets)

Nested sets or [Nested Set Model](http://en.wikipedia.org/wiki/Nested_set_model) is a way to effectively store hierarchical data in a relational table. From wikipedia:

> The nested set model is to number the nodes according to a tree traversal, which visits each node twice, assigning numbers in the order of visiting, and at both visits. This leaves two numbers for each node, which are stored as two attributes. Querying becomes inexpensive: hierarchy membership can be tested by comparing these numbers. Updating requires renumbering and is therefore expensive.

### Applications

[](#applications)

NSM shows good performance when tree is updated rarely. It is tuned to be fast for getting related nodes. It is ideally suited for building multi-depth menu or categories for shop.

Requirements
------------

[](#requirements)

- PHP: 8.2+
- Laravel: ^11.\*|^12.\*

It is highly suggested to use database that supports transactions (like Postgres) to secure a tree from possible corruption.

Installation
------------

[](#installation)

```
composer require lordsimal/laravel-trees
```

Testing
-------

[](#testing)

The testing environment expects a PostgreSQL database to be available via localhost:5432

You can use the provided `docker-compose.yml` file to start a PostgreSQL database via `docker-compose up`.

After that you can run the tests with:

```
./vendor/bin/phpunit
# or
composer test
```

Documentation
-------------

[](#documentation)

The package allows to create multi-root structures: no only-one-root! And allows to move nodes between trees.
Moreover, it also works with different model's primary key: `int`, `uuid`, `ulid`.

- [Basic](docs/Basic.md)
- [AdvancedTreeConfig](docs/AdvancedTreeConfig.md)
- [Migration](docs/Migration.md)
- [Creating Nodes](docs/CreatingNodes.md)
- [Managing Nodes](docs/ManagingNodes.md)
- [Receiving Nodes](docs/ReceivingNodes.md)
- [Model's Helpers](docs/Helpers.md)
- [Console](docs/Console.md)
- [Health And Fixing.md](docs/HealthAndFix.md)

Credit where credit is due
--------------------------

[](#credit-where-credit-is-due)

This plugin is based on the [Laravel Tree Structure from Eugene Fureev](https://github.com/efureev/laravel-trees)

License
-------

[](#license)

The plugin is available as open source under the terms of the [MIT License](https://github.com/lordsimal/laravel-trees/blob/main/LICENSE).

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance55

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/bfa3748cb4e1bf824128dc4b23bce7f80654dd560a002048c89c567ef67c0928?d=identicon)[LordSimal](/maintainers/LordSimal)

---

Top Contributors

[![LordSimal](https://avatars.githubusercontent.com/u/9105243?v=4)](https://github.com/LordSimal "LordSimal (10 commits)")

### Embed Badge

![Health badge](/badges/lordsimal-laravel-trees/health.svg)

```
[![Health](https://phpackages.com/badges/lordsimal-laravel-trees/health.svg)](https://phpackages.com/packages/lordsimal-laravel-trees)
```

###  Alternatives

[bluemmb/faker-picsum-photos-provider

picsum.photos provider for Faker

29238.7k2](/packages/bluemmb-faker-picsum-photos-provider)[aw-studio/laravel-states

445.6k](/packages/aw-studio-laravel-states)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)