cline/warden

Eloquent roles and abilities.

1.3.28 2025-11-16 02:58 UTC

Requires

• php: ^8.4.0
• cline/ruler: ^3.0.2
• illuminate/auth: ^12.0
• illuminate/cache: ^12.0
• illuminate/console: ^12.0
• illuminate/container: ^12.0
• illuminate/contracts: ^12.0
• illuminate/database: ^12.0
• illuminate/events: ^12.0
• spatie/laravel-package-tools: ^1.92.7

Requires (Dev)

• cline/php-cs-fixer: ^1.1.0
• driftingly/rector-laravel: ^2.1.3
• ergebnis/composer-normalize: ^2.49@dev
• larastan/larastan: ^3.8
• laravel/pint: ^1.25.1
• orchestra/testbench: ^10.6
• pestphp/pest: ^4.1.3
• pestphp/pest-plugin-drift: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-type-coverage: ^4.0.3
• phpstan/phpstan: ^2.1.32
• rector/rector: ^2.2.8
• symfony/var-dumper: ^7.3.5

MIT

• Brian Faust

• capabilities
• acl
• laravel
• roles
• permissions
• eloquent
• abilities

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.