Laravel Permission adds role based permissions to built in Auth System of Laravel 5. Permission middleware protects routes and even crud controller methods.
- This package requires PHP 5.4+
- Require the package in your
composer.json
and update your dependency withcomposer update
:
"require": {
...
"tuvaergun/permission": "~1.0@dev",
...
},
- Add the package to your application service providers in
config/app.php
.
'providers' => [
'Illuminate\Foundation\Providers\ArtisanServiceProvider',
'Illuminate\Auth\AuthServiceProvider',
...
'Tuva\Permission\PermissionServiceProvider',
],
- Publish the package migrations to your application and run these with `php artisan migrate.
$ php artisan vendor:publish --provider="Tuva\Permission\PermissionServiceProvider"
Use your own models. Once you publish, it publishes the configuration file where you can define your own models which should extend to Permission models.
- Add the middleware to your
app/Http/Kernel.php
.
protected $routeMiddleware = [
....
'permission' => 'Tuva\Permission\Middleware\HasPermission',
];
- Add the HasRole trait to your
User
model.
use Tuva\Permission\Traits\HasRole;
class User extends Model implements AuthenticatableContract, CanResetPasswordContract
{
use Authenticatable, CanResetPassword, HasRole;
}
Follow along the Wiki to find out more.
Here's the TODO list for the next release (2.0).
- Refactoring the source code.
- Correct all issues.
- Adding cache to final user permissions.
- Adding tests.
June 14, 2015 (latest)
- Added backward compatibility to l5.0 for lists() method.
- Added Blade Template Extensions.
March 28, 2015
- Added Role Scope to get all users having a specific role. e.g
User::role('admin')->get();
will list all users havingadmin
role.
March 7, 2015
-
is()
andcan()
methods now support comma forAND
and pipe asOR
operator. Or pass an operator as a second param. more information - You can bind multiple permissions together so they inherit ones permission. more information
Support follows PSR-2 PHP coding standards, and semantic versioning.
Please report any issue you find in the issues page. Pull requests are welcome.