README

Warden is an elegant library for managing roles and permissions in Laravel applications. It provides a simple, expressive API for authorization that integrates seamlessly with Laravel's native authorization system.

This is a fork of Bouncer by Joseph Silber, exploring alternative organizational patterns while maintaining compatibility.

Requirements

Requires PHP 8.4+ and Laravel 12+

Installation

composer require cline/warden

Documentation

• Getting Started - Installation, configuration, and basic concepts
• Roles and Abilities - Creating and managing roles and permissions
• Model Restrictions - Scoping abilities to specific models
• Ownership - Handling ownership-based permissions
• Removing Permissions - Disallowing and syncing abilities
• Forbidding - Explicit denials and blanket restrictions
• Checking Permissions - Various ways to check authorization
• Querying - Finding users by roles and abilities
• Authorization - Integration with Laravel's authorization system
• Multi-Tenancy - Scoping permissions per tenant
• Configuration - Advanced configuration options
• Console Commands - Artisan commands for maintenance

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
• Joseph Silber
• All Contributors

License

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