yard8/laravel-permissions

Creates user roles and the various permissions your application would use for authorisation.

1.0.5 2020-04-22 11:09 UTC

Requires

• php: ^7.1
• illuminate/support: ^5.5|^6|^7

Requires (Dev)

• orchestra/testbench: 3.8.*
• phpunit/phpunit: ^7.0

MIT

• Jason Hodkinson

• laravel-permissions
• yard8

README

The purpose of this package is to create both roles and permissions which could be assigned to a user and used during authorisation or policy checks.

Installation

You can install the package via composer:

composer require yard8/laravel-permissions

Publish the config and migration files:

php artisan laravel-permissions:install

Add on a role_id column which is an unsigned bigInteger to the users table which will be related to both the roles and permissions:

Setup the config permissions.php to include the roles and permissions you want in your application.

Insert the roles and permissions into your database:

php artisan laravel-permissions:insert

Add the HasPermissions trait to the model you want to have the roles and permissions:

<?php

namespace App;

use Yard8\LaravelPermissions\Traits\HasPermissions;

class User extends Authenticatable
{
    use HasPermissions;
}

Usage

// Assign the authenticated user to a variable.
$user = auth()->user();

// Get the role of the user.
$role = $user->role;

// If the user is granted the role admin, both will return true. If the user has neither of these roles they will both return false.
$isAdmin = $user->hasRole('admin');
$isAdminOrManager = $user->hasRole(['admin', 'manager']);

// Get the permissions of the user.
$permissions = $user->permissions;

// If the user has the permission can-post, both will return true. If the user has neither of these permissions, they will both return false.
$canPost = $user->hasPermission('can-post');
$canPostOrComment = $user->hasAnyPermission(['can-post', 'can-comment']);

Changelog

Please see CHANGELOG for more information what has changed recently.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Jason Hodkinson

License

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

Laravel Package Boilerplate

This package was generated using the Laravel Package Boilerplate.