guisgdias/laravel-acl

Light-weight role-based permissions for Laravel 5 built in Auth system.

Kodeine/Laravel-ACL

, _(*1)

Laravel ACL adds role based permissions to built in Auth System of Laravel 5. ACL middleware protects routes and even crud controller methods., _(*2)

Table of Contents

• Requirements
• Getting Started
• Documentation
• Roadmap
• Change Logs
• Contribution Guidelines

Requirements

• This package requires PHP 5.4+

Getting Started

1. Require the package in your composer.json and update your dependency with composer update:

"require": {
...
"kodeine/laravel-acl": "~1.0@dev",
...
},

1. Add the package to your application service providers in config/app.php.

'providers' => [

'Illuminate\Foundation\Providers\ArtisanServiceProvider',
'Illuminate\Auth\AuthServiceProvider',
...
'Kodeine\Acl\AclServiceProvider',

],

1. Publish the package migrations to your application and run these with `php artisan migrate.

$ php artisan vendor:publish --provider="Kodeine\Acl\AclServiceProvider"

Use your own models. Once you publish, it publishes the configuration file where you can define your own models which should extend to Acl models., _(*3)

1. Add the middleware to your app/Http/Kernel.php.

protected $routeMiddleware = [

....
'acl' => 'Kodeine\Acl\Middleware\HasPermission',

];

1. Add the HasRole trait to your User model.

use Kodeine\Acl\Traits\HasRole;

class User extends Model implements AuthenticatableContract, CanResetPasswordContract
{
use Authenticatable, CanResetPassword, HasRole;
}

Documentation

Follow along the Wiki to find out more., _(*4)

Roadmap

Here's the TODO list for the next release (2.0)., _(*5)

• [ ] Refactoring the source code.
• [ ] Correct all issues.
• [ ] Adding cache to final user permissions.
• [ ] Adding tests.

Change Logs

June 14, 2015 (latest) * [x] Added backward compatibility to l5.0 for lists() method. * [x] Added Blade Template Extensions., _(*6)

March 28, 2015 * [x] Added Role Scope to get all users having a specific role. e.g User::role('admin')->get(); will list all users having admin role., _(*7)

March 7, 2015 * [x] is() and can() methods now support comma for AND and pipe as OR operator. Or pass an operator as a second param. more information * [x] You can bind multiple permissions together so they inherit ones permission. more information, _(*8)

Contribution Guidelines

Support follows PSR-2 PHP coding standards, and semantic versioning., _(*9)

Please report any issue you find in the issues page. Pull requests are welcome., _(*10)