Download the PHP package mistery23/laravel-roles without Composer

On this page you can find all versions of the php package mistery23/laravel-roles. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-roles

Laravel Roles

Table of contents

About

A Powerful package for handling roles and permissions in Laravel. Supports Laravel 5.8, and 6.0.

Features

Laravel Roles Features
Built in migrations with ability to publish and modify your own.
Built in command with ability to modify your own seed data from config.
Roles with levels and relationships to users, permissions
Permissions with relationships to users and levels
Extended role and permission
Soft deletes with full restore and destroy
Optional Api methods for manage Roles and Permissions
Lots of configuration options
Lots of configuration seed
All Extendable from .env

Installation

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

Composer

From your projects root folder in terminal run:

Laravel 5.8 and up use:

Service Provider

Publish All Assets

Publish Specific Assets

HasRoleAndPermission Trait And Contract

  1. Include HasRoleAndPermission trait and also implement HasRoleAndPermission contract inside your User model. See example below.

  2. Include use Mistery23\LaravelRoles\Traits\HasRoleAndPermission; in the top of your User model below the namespace and implement the HasRoleAndPermission trait. See example below.

Example User model Trait And Contract:

Migrations and seeds

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

  1. Setup the needed tables:

    php artisan migrate

  2. Check config/roles-seed.php. For create/update your role and perm.
  3. Setup role and perm:

    php artisan roles:gen

  4. Seed an initial set of Permissions, Roles. Attach role/permission to user please implement in your project. For this you should use complete use cases:

    Mistery23\LaravelRoles\Model\UseCases\User\Attach\Role Mistery23\LaravelRoles\Model\UseCases\User\Attach\Permission

Roles Seeded

Property Value
Name Root
Slug root
Description Root role
Level 100
Property Value
Name Admin
Slug admin
Description Admin role
Level 90
Parent root
Permissions portal.administrate
Property Value
Name Manager
Slug manager
Description Manager role
Level 70
Parent admin
Permissions portal.user.manage, portal.user.manage.create
Property Value
Name Client
Slug client
Description Client role
Level 50

Permissions Seeded:

Property Value
name Portal administrate
slug portal.administrate
description Can administrate portal
Property Value
name Portal manage user
slug portal.user.manage
description Can manage user
parent portal.administrate
Property Value
name Portal user create
slug portal.user.manage.create
description Can user create
parent portal.user.manage.create
Property Value
name Portal client
slug portal.use
description Can use portal

Usage

Creating Roles

Attaching, Detaching Role and Permissions

See Mistery23\LaravelRoles\Model\UseCases\... for all actions for role, permission and user.

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.

Checking For Permissions

You can check for multiple permissions the same way as roles. You can make use of additional methods like hasOnePermission or hasAllPermissions.

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. The middleware aliases are already registered in \Mistery23\LaravelRoles\RolesServiceProvider.

Now you can easily protect your routes.

It throws \Mistery23\LaravelRoles\App\Exceptions\RoleDeniedException, \Mistery23\LaravelRoles\App\Exceptions\PermissionDeniedException or \Mistery23\LaravelRoles\App\Exceptions\LevelDeniedException exceptions if it goes wrong.

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


Configuration

Configuration seed data

Tests

Environment File

Optional API Routes

File Tree

License

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


All versions of laravel-roles with dependencies

PHP Build Version
Package Version
Requires php Version >=7.3
ext-pdo Version *
laravel/framework Version ~5.8.0|^6.0
illuminate/support Version ~5.8.0|^6.0
laravel/helpers Version ^1.1
mistery23/eloquent-object-relations Version ^1.2
mistery23/eloquent-flusher Version ^2.0
ramsey/uuid Version ^3.8
staudenmeir/laravel-adjacency-list Version ^1.0
webmozart/assert Version 1.6.*
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package mistery23/laravel-roles contains the following files

Loading the files please wait ....