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

• Brian Faust
• All Contributors

License

The MIT License. Please see License File for more information.