README

Flexible authorization for Laravel with support for 11+ access control models. Choose the model that fits your needs - from simple ACL to complex ABAC - or combine multiple models in the same application.

Requirements

Requires PHP 8.2+ Requires Laravel 11.0+

Installation

composer require cline/patrol

Publish the configuration:

php artisan vendor:publish --tag=patrol-config

Documentation

Getting Started

• Quick Start - Get up and running in minutes
• Quick Reference - Choose your model in 2 minutes
• Beginner's Path - ACL → RBAC → ABAC learning path

Authorization Models

• Authorization Models Overview - All 11 models with examples
• ACL Models - Access Control List (basic, superuser, without users, without resources)
• RBAC Models - Role-Based Access Control (basic, resource roles, domains)
• ABAC - Attribute-Based Access Control
• RESTful - HTTP path/method authorization
• Security Patterns - Deny-Override and Priority-Based

Guides

• API Reference - Complete API documentation
• Policy Builders - Fluent APIs for building policies
• CLI Tools - Test and debug from command line
• Configuration - Complete configuration guide
• Persisting Policies - Database, cache, and file storage

Advanced Topics

• Complete Cookbook - Comprehensive guides and patterns
• Delegation - Policy delegation patterns
• Native Delegation - Laravel native authorization

Change log

Please see the Releases 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.