Download the PHP package geniusts/roles without Composer

Roles And Permissions For Laravel 6+

This package is forked from bican/roles package.

• Installation
  • Composer
  • Config File And Migrations
  • HasRoleAndPermission Trait And Contract
• Usage
  • Creating Roles
  • Attaching And Detaching Roles
  • Checking For Roles
  • Levels
  • Creating Permissions
  • Attaching And Detaching Permissions
  • Checking For Permissions
  • Permissions Inheriting
  • Entity Check
  • Blade Extensions
  • Middleware
• Config File
• More Information
• License

Installation

This package is very easy to set up. There are only couple of steps.

Composer

Pull this package in through Composer (file composer.json).

If you are still using Laravel 5.0, you must pull in version 1.7.*. and for Laravel 5.2, you must pull in version 2.1.*. and for Laravel 5.3 and greater, you must pull in version 3.*.

Run this command inside your terminal.

composer update

Config File And Migrations

Run migrate command to update your database.

php artisan migrate

If you want to publish the package config file and migrations to your application. Run these commands inside your terminal.

php artisan vendor:publish --provider="GeniusTS\Roles\RolesServiceProvider" --tag=config
php artisan vendor:publish --provider="GeniusTS\Roles\RolesServiceProvider" --tag=migrations

This uses the default users table which is in Laravel. You should already have the migration file for the users table available and migrated.

HasRoleAndPermission Trait And Contract

Include HasRoleAndPermission trait and also implement HasRoleAndPermission contract inside your User model.

And that's it!

Usage

Creating Roles

Because of Slugable trait, if you make a mistake and for example leave a space in slug parameter, it'll be replaced with a dot automatically, because of str_slug function.

Attaching And Detaching Roles

It's really simple. You fetch a user from database and call attachRole method. There is BelongsToMany relationship between User and Role model.

Checking For Roles

You can now check if the user has required role.

You can also do this:

And of course, there is a way to check for multiple roles:

Levels

When you are creating roles, there is optional parameter level. It is set to 1 by default, but you can overwrite it and then you can do something like this:

If user has multiple roles, method level returns the highest one.

Level has also big effect on inheriting permissions. About it later.

Creating Permissions

It's very simple thanks to Permission model.

Attaching And Detaching Permissions

You can attach permissions to a role or directly to a specific user (and of course detach them as well).

Checking For Permissions

You can check for multiple permissions the same way as roles. You can make use of additional methods like canOne, canAll or hasPermission.

Permissions Inheriting

Role with higher level is inheriting permission from roles with lower level.

There is an example of this magic:

You have three roles: user, moderator and admin. User has a permission to read articles, moderator can manage comments and admin can create articles. User has a level 1, moderator level 2 and admin level 3. It means, moderator and administrator has also permission to read articles, but administrator can manage comments as well.

If you don't want permissions inheriting feature in you application, simply ignore level parameter when you're creating roles.

Entity Check

Let's say you have an article and you want to edit it. This article belongs to a user (there is a column user_id in articles table).

This condition checks if the current user is the owner of article. If not, it will be looking inside user permissions for a row we created before.

Blade Extensions

There are four Blade extensions. Basically, it is replacement for classic if statements.

Middleware

This package comes with VerifyRole, VerifyPermission and VerifyLevel middleware. You must add them inside your app/Http/Kernel.php file.

Now you can easily protect your routes.

It throws \GeniusTS\Roles\Exceptions\RoleDeniedException, \GeniusTS\Roles\Exceptions\PermissionDeniedException or \GeniusTS\Roles\Exceptions\LevelDeniedException exceptions if it goes wrong.

You can catch these exceptions inside app/Exceptions/Handler.php file and do whatever you want.

Config File

You can change connection for models, slug separator, models path and there is also a handy pretend feature. Have a look at config file for more information.

License

This package is free software distributed under the terms of the MIT license.