s00d/permissions

Laravel 5 package for handling user roles and permissions.

Permissions

Tiny Laravel 5 package for handling user roles and permissions., _(*1)

Installation

Add the following to the require key of your composer.json file:, _(*2)

"s00d/permissions": "dev-master"

Run $ composer update., _(*3)

Navigate to your config/app.php file and add 's00d\Permissions\PermissionsServiceProvider' to the $providers array., _(*4)

Create the tables by running $ php artisan migrate package="s00d/permissions". Ensure that your users table exists first., _(*5)

Navigate to your models/User.php file and add the s00d\Permissions\Can trait below the class decloration line:, _(*6)

class User extends Eloquent implements UserInterface, RemindableInterface {
    use s00d\Permissions\Can;

Usage

Create a new role:, _(*7)

$role = new \s00d\Permissions\Role();
$role->name = 'Administrator';
$role->save();

Create a new permission:, _(*8)

$permission = new \s00d\Permissions\Permission();
$permission->name = 'read_articles';
$permission->display_name ='Can read articles';
$permission->save();

Attach the permission to the role:, _(*9)

$role->allow($permission);

Create a user:, _(*10)

$user = new User;
$user->role_id = 1;
$user->save();

And you're set! To check if a user has a permission:, _(*11)

$user = User::find(1);

if ($user->can('read_articles'))
    echo 'The user with the ID of "1" can read articles';

To check if the current authenticated user has a permission:, _(*12)

if (Auth::user()->can('read_articles'))
    echo 'The current authenticated user can read articles';