yusronarif / laravel-rbac
Permission handling for Laravel 5.8 and up
Requires
- php: ^7.2
- illuminate/auth: ^5.8|^6.0
- illuminate/container: ^5.8|^6.0
- illuminate/contracts: ^5.8|^6.0
- illuminate/database: ^5.8|^6.0
- yusronarif/laravel-core: ~2.0
Requires (Dev)
- orchestra/testbench: ^3.8|^4.0
- phpunit/phpunit: ^8.0
- predis/predis: ^1.1
This package is auto-updated.
Last update: 2024-10-29 05:59:57 UTC
README
Origin Sources
Origin forked from spatie/laravel-permission
This package allows you to manage user permissions and roles in a database.
Once installed you can do stuff like this:
// Adding permissions to a user $user->givePermissionTo('edit articles'); // Adding permissions via a role $user->assignRole('writer'); $role->givePermissionTo('edit articles');
Because all permissions will be registered on Laravel's gate, you can check if a user has a permission with Laravel's default can
function:
$user->can('edit articles');
Documentation, Installation, and Usage Instructions
See the documentation site for detailed installation and usage instructions.
Need a UI?
The package doesn't come with any screens out of the box, you should build that yourself. Here are some options to get you started:
-
Laravel Nova package by @vyuldashev for managing Roles and Permissions
-
Extensive tutorial for building permissions UI by Caleb Oki.
-
Laravel User Management for managing users, roles, permissions, departments and authorization by Mekaeil
Testing
composer test
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security-related issues, please email freek@spatie.be instead of using the issue tracker.
Postcardware
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
We publish all received postcards on our company website.
Credits
This package is heavily based on Jeffrey Way's awesome Laracasts lessons on permissions and roles. His original code can be found in this repo on GitHub.
Special thanks to Alex Vanderbist who greatly helped with v2
, and to Chris Brown for his longtime support helping us maintain the package.
Alternatives
- Povilas Korop did an excellent job listing the alternatives in an article on Laravel News. In that same article, he compares laravel-permission to Joseph Silber's Bouncer, which in our book is also an excellent package.
- ultraware/roles takes a slightly different approach to its features.
- santigarcor/laratrust implements team support
- zizaco/entrust offers some wildcard pattern matching
Support us
Spatie is a web design agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.
License
The MIT License (MIT). Please see License File for more information.