cline/ancestry
| Install | |
|---|---|
composer require cline/ancestry |
|
| Latest Version: | 2.1.0 |
| PHP: | ^8.5.0 |
| Laravel: | 10 – 13 |
| License: | MIT |
| Last Updated: | Oct 22, 2026 |
| Links: | GitHub · Packagist |
Ancestry
Closure table hierarchies for Eloquent models with O(1) ancestor/descendant queries.
Ancestry implements the closure table pattern for managing hierarchical relationships in Laravel. This enables efficient queries for ancestors and descendants without recursion limits, supporting deeply nested relationships like organizational charts, sales hierarchies, and category trees.
Documentation
- Getting Started - Installation, requirements, and quick start
- Basic Usage - Core operations and trait methods
- Fluent API - Chainable, expressive interface
- Configuration - Customize keys, morphs, depth limits
- Multiple Hierarchy Types - One model, many hierarchies
- Custom Key Mapping - Advanced key configuration
- Events - React to hierarchy changes
- Snapshots - Capture point-in-time hierarchy state
Change log
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING and CODE_OF_CONDUCT for details.
Security
If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.
Credits
License
The MIT License. Please see License File for more information.
Related Packages
Nested set (modified preorder tree traversal) for Eloquent models: ordered trees...
Expandable parent/child tree rows for Filament v4.3+ & v5 tables — inline sub-ro...
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| 2.1.0 | ^8.5.0 | ^10.0 || | MIT | |
| 2.0.3 | ^8.5.0 | ^10.0 || | MIT | |
| 2.0.2 | ^8.5.0 | ^10.0 || | MIT | |
| 2.0.1 | ^8.5.0 | ^10.0 || | MIT | |
| 2.0.0 | ^8.5.0 | ^10.0 || | MIT | |
| 1.8.1 | ^8.5.0 | ^10.0 || | MIT | |
| 1.8.0 | ^8.5.0 | ^10.0 || | MIT | |
| 1.7.0 | ^8.5.0 | ^10.0 || | MIT |