Download the PHP package zorca/roles-and-permissions without Composer
On this page you can find all versions of the php package zorca/roles-and-permissions. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download zorca/roles-and-permissions
More information about zorca/roles-and-permissions
Files in zorca/roles-and-permissions
Package roles-and-permissions
Short Description Implement roles and permissions on your laravel application, supports many-to-many relationship (pivot tables).
License MIT
Homepage https://github.com/ajimoti/roles-and-permissions
Informations about the package roles-and-permissions
Simple Laravel roles and permissions
Introduction
This package allows you to assign roles and permissions to any laravel model, or on a pivot table (many to many relationship
).
Built and written by Ajimoti Ibukun
Documentation
You can read the proper documentation here
Quick Samples
On a Model
The example below explains how to use the package on a model after installation.
Pivot table (many to many relationship)
This demonstrates how to use the package on a many to many
relationship.
In this example, we assume we have a merchant
relationship in our User
model. And this relationship returns an instance of Laravel's BelongsToMany
class.
Import the App\Enums\Role
and App\Enums\Permission
class.
We used the
user
model to make the example explanatory, similar to the examples above the package will work on any model class.
Requirements
- PHP 8.0 or higher
- Laravel 8.0 or higher
- Upon installation, the package publishes a
config/roles-and-permissions.php
file, ensure you do not have a file with the same name in your config directory.
Pros
- The package can be used on any model, i.e any model can be assigned roles, and permissions.
- Roles can be given multiple permissions.
- Models have permissions via roles.
- Models can be assigned multiple roles.
- A
many to many
relationship can be assigned roles. (i.e the package can be used on a pivot table). - Supports role hierarchy. (A higher level role can be configured to have the permissions of lower level roles).
Crons
- Permissions cannot be assigned directly on a
many to many
relationship.
Installation
You can install the package via composer:
If you have existing pivot tables that you want to apply the package on, you can add the table names to the pivot.tables
array in the config/roles-and-permissions.php
config file. The command below will add a role
column to every pivot table provided in the array.
Run the command below, then you are set to use the package.
Documentation
Visit https://roles.ajimoti.com/docs/intro to better understand how to use the package.
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
- ajimoti
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of roles-and-permissions with dependencies
bensampo/laravel-enum Version ^4.1
illuminate/contracts Version ^8.73
spatie/laravel-package-tools Version ^1.9.2