Home > Article > Backend Development > 使用 Entrust 扩展包在 Laravel 5 中实现 RBAC 权限管理(一):安装配置篇
Entrust为我们在Laravel中实现基于角色的权限管理(RBAC)提供了简洁灵活的方式。
想要在Laravel中使用Entrust,首先需要通过Composer来安装其依赖包:
composer require zizaco/entrust 5.2.x-dev
安装完成后需要在 config/app.php中注册服务提供者到 providers数组:
Zizaco\Entrust\EntrustServiceProvider::class,
同时在该配置文件中注册相应门面到 aliases数组:
'Entrust' => Zizaco\Entrust\EntrustFacade::class,
如果你想要使用中间件(要求Laravel 5.1或更高版本)还需要添加如下代码到 app/Http/Kernel.php的 routeMiddleware数组:
'role' => \Zizaco\Entrust\Middleware\EntrustRole::class,'permission' => \Zizaco\Entrust\Middleware\EntrustPermission::class,'ability' => \Zizaco\Entrust\Middleware\EntrustAbility::class,
在配置文件 config/auth.php中设置合适的值,Entrust会使用这些配置值来选择相应的用户表和模型类。
你还可以发布该扩展包的配置以便后续自定义相关表名以及模型类的命名空间:
php artisan vendor:publish
该命令会在 config目录下创建一个 entrust.php文件。
接下来我们使用Entrust提供的迁移命令生成迁移文件:
php artisan entrust:migration
然后通过以下命令生成相应的数据表:
php artisan migrate
最终会生成4张新表:
Role
我们需要创建Role模型类 app/Models/Role.php并编辑其内容如下:
<?php namespace App;use Zizaco\Entrust\EntrustRole;class Role extends EntrustRole{}
Role模型拥有三个主要属性:
display_name和 description属性都是可选的,在数据库中的相应字段默认为空。
Permission
接下来创建Permission模型 app/models/Permission.php并编辑其内容如下:
<?php namespace App;use Zizaco\Entrust\EntrustPermission;class Permission extends EntrustPermission{}
Permission模型也有三个主要属性:
User
接下来我们在 User模型中使用 EntrustUserTrait:
<?phpuse Zizaco\Entrust\Traits\EntrustUserTrait;class User extends Eloquent{ use EntrustUserTrait; // add this trait to your user model ...}
这将会建立 User与 Role之间的关联关系:在 User模型中添加 roles()、 hasRole($name)、 can($permission)以及 ability($roles,$permissions,$options)方法。
软删除
使用Entrust提供的迁移命令生成的关联关系表中默认使用了 onDelete('cascade')以便父级记录被删除后会移除其对应的关联关系。如果你由于某种原因不能在数据库中使用级联删除,那么可以EntrustRole、EntrustPermission类以及HasRole trait提供的事件监听器手动删除关联表中的记录。如果模型使用了软删除,那么当不小心误删除数据时,事件监听器将不会删除关联表数据。然而,由于Laravel事件监听器的局限性,所以暂时无法区分是调用 delete()还是 forceDelete(),基于这个原因,在你删除一个模型之前,必须手动删除所有关联数据(除非你的数据表使用了级联删除):
$role = Role::findOrFail(1); // Pull back a given role// Regular Delete$role->delete(); // This will work no matter what// Force Delete$role->users()->sync([]); // Delete relationship data$role->perms()->sync([]); // Delete relationship data$role->forceDelete(); // Now force delete will work regardless of whether the pivot table has cascading delete
下一节我们将来演示如何在Laravel中使用Entrust实现RBAC。