Laravel-Permission 使用心得

最近在研究laravel的权限管理，比较了entrust,Bouncer 还是觉得laravel-permission比较好用。好了，废话不多说，开始主题吧！

安装

这是github的地址，上边有安装的方法和简单的使用，这个我就不多说了，自己去看一下 https://github.com/spatie/laravel-permission

使用

1.执行完github上的命令，你的数据库有
roles role_has_permissions permissions model_has_roles model_has_permission

2.在你的项目里 你不需要为role permission建立model，，你只需要userModel

3.在userModel里加上

use Illuminate\Foundation\Auth\User as Authenticatable;use Spatie\Permission\Traits\HasRoles;class UserModel extends Authenticatable{    use HasRoles;    protected $guard_name = 'web';    //your code}

new一个UserModel对象,这些方法都可以使用了，
1. user−>assignRole(‘writer′);2.user->removeRole(‘writer’);
3. user−>syncRoles(params);（这个方法我个人比较喜欢，当我们改变一个user的角色时候，用它最好不过了，它会把本来有的角色给你取消，然后赋予新的角色，这样特别省事，还能一次赋予好几个角色）4.role->givePermissionTo(‘edit articles’);
5. role−>revokePermissionTo(‘editarticles′);6.role->syncPermissions(params);

个人使用心得

---

PS：强烈建议在 UserModel 里面添加上 guard_name 字段，并赋予值。在创建新role时候，也手动指定 guard_name的值，原因有二：
1.这个值会一并插入到表里 guard_name 字段，该字段默认不能为null
2.这个是区分role的字段，
eg: post-manager web;
post-manager admin;
这两个roleName一样，但是guard_name不一样，这也是两个角色;
说的通俗一点，guard_name这个值有点“分组”的概念。

在创建新role的时候，guard_name如果没有，那就取auth.defaults.guard的值，这个laravel默认是“web”，这是源码

public static function create(array $attributes = [])    {        $attributes['guard_name'] = $attributes['guard_name'] ?? config('auth.defaults.guard');        if (static::where('name', $attributes['name'])->where('guard_name', $attributes['guard_name'])->first()) {            throw RoleAlreadyExists::create($attributes['name'], $attributes['guard_name']);        }        if (app()::VERSION < '5.4') {            return parent::create($attributes);        }        return static::query()->create($attributes);    }

使用 assignRole() syncRoles(); getRoleNames()这些方法的时候，回去根据$guard_name值去判断角色是否存在，如果你没有在UserModel里面指明，它会去取config\auth.php的 guards的值,这是源码

protected function getGuardNames(): Collection    {        if ($this->guard_name) {            return collect($this->guard_name);        }        return collect(config('auth.guards'))            ->map(function ($guard) {                return config("auth.providers.{$guard['provider']}.model");            })            ->filter(function ($model) {                return get_class($this) === $model;            })            ->keys();    }

可以看出 如果你的类里定义了 guard_name 那就直接取出，否则去取config\auth.php 的 guards里的一个model对应的key值作为guard_name，根据这个值去判断角色的存不存在。

我在使用的时候就遇到一个问题，数据里角色明明有，但是一执行assignRole(‘post-manager’)就报 “找不到角色”的错误。后来看了源码才知道是这样：
我的guards是自己添加，我自己在config\auth.php里的guards数组里添加
‘admin’=>[
‘driver’ => ‘session’,
‘provider’ => ‘admins’,
],
也就是说在assignRole() getRoleNames()的时候，guard_name的值是 ‘admin’

这就是问题的所在，创建的时候默认的是web(auth.defaults.guard)，但是查询role的时候是admin(guards里的一个model对应的key值),所以会说“找不到角色这个问题”
所以，再次强调一下，

1.创建新role的时候，guard_name手动添加到数组里面
2.在UserModel里定义了protected= $guard_name,并赋予和上一步一样的值（这样它就不会再去config\auth.php里的guards数组去取值了，就不会出现guard_name不一致的情况）

---

我个人比较喜欢的是 user->role->permission的方式，user只拥有role，而role只拥有permission 这样user的权限完全取决于它的角色，user不会直接跟permission打交道
而Laravel-Permission 是可以直接给user赋予permission（model_has_permissions表就是干这个的）。如果按我比较喜欢的风格，这个表就用不到了 。