Download the PHP package guava/simple-permissions without Composer

Simple permission and role system for Laravel. Supports enums.

This is an opinionated simple permissions & roles system for Laravel. It allows you to define roles and permissions as PHP classes and enums directly in your codebase. This allows for out of the box auto-completion support and superb developer experience.

Showcase

This is where your screenshots and videos should go. Remember to add them, so people see what your plugin does.

Support us

Your support is key to the continual advancement of our plugin. We appreciate every user who has contributed to our journey so far.

While our plugin is available for all to use, if you are utilizing it for commercial purposes and believe it adds significant value to your business, we kindly ask you to consider supporting us through GitHub Sponsors. This sponsorship will assist us in continuous development and maintenance to keep our plugin robust and up-to-date. Any amount you contribute will greatly help towards reaching our goals. Join us in making this plugin even better and driving further innovation.

Installation

You can install the package via composer:

You can publish and run the migrations with:

You have to reneme the migration: 0000_00_00_000000_create_permissions_table.php!

You can publish the config file with:

This is the contents of the published config file:

Usage

Model setup

You need to add the HasAccessControl trait to your models that you want to add roles and permissions to.

This will add all necesary relationships and methods to start using access control.

Creating permissions

Permissions can be created using an artisan command. Let's say you have a model Post and want to create permissions for handling access to the Post resource.

Simply run:

This will create a new enum in App\Auth\Permissions\PostPermissions with some predefined CRUD permissions:

Creating Roles

Roles can be created using an artisan command.

Simply run:

This will create a new role in App\Auth\Roles\SuperAdmin:

Checking if a user has a permission

You can use Laravel's built-in methods to check permissions:

For example if a user has permissions to view a post, you could do:

FilamentPHP integration

All you need to do in order to add access control to your filament resources is to implement the HasAuthorization trait in your resource and define the Permission enum.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Lukas Frey
• All Contributors
• Spatie - Our package simple-permissions-for-laravel is a modified version of Spatie's Package SimplePermissions

License

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