laravel5.5.50之权限(laravel-permissions)的使用

目录

一、安装laravel-permissions扩展

二、生成数据库迁移文件

三、执行数据迁移

四、php artisan migrate 生成的表

五、生成配置信息

六、permission.php 文件的使用和说明

七、在user模型下加载角色相关信息

八、测试角色、权限

九、有关用户、角色、权限方法的使用

十、权限中间件的使用

十一、使用 artisan 命令操作权限

十二、权限缓存的使用

一、安装laravel-permissions扩展

#不指定安装版本的命令composer require spatie/laravel-permission#指定安装版本的命令composer require "spatie/laravel-permission:~2.7"

 说明：~2.7是安装的版本,因为需要根据框架的版本选择permission扩展的版本（根据个人框架版本来选择。我安装的是2.7版本）

二、生成数据库迁移文件

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="migrations"

 执行完生成迁移文件命令，就会在 \database\migrations 目录下，生成一个以_create_permission_tables.php 结尾的文件。

三、执行数据迁移

php artisan migrate

 如果MySQL版本低，执行完命令就会报错，错误如下

意思就是：MySQL版本低，列的字段长度太长。
解决方法：修改app里的providers里的AppServiceProvider.php文件

\Schema::defaultStringLength(191);

 再次执行：php artisan migrate 命令即可

四、php artisan migrate 生成的表

1. 首先是用户表(users)都是一些基本用户信息包括名字、邮箱、密码什么的。
2. 权限表（permissions）权限表就是存放所有权限的一张表，权限可以是控制器访问权限，接口访问权限，model访问权限。
3. 角色表（roles）角色表就是存放你所有的角色。
4. 用户权限表（model_has_permissions）这张表记录的就是model_id,permission_id的多对多的关系表，用户直接获取权限。
5. 用户角色表（model_has_roles）这张表记录的用户拥有的角色，表里有model_id,role_id这个也是记录用户和角色多对多的关系表。
6. 角色权限表（role_has_permissions）这张表记录的是角色拥有哪些权限，表里就2个字段role_id,permission_id，也可以根据需要进行拓展！

五、生成配置信息

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="config"

 会在 config 目录下生成一个：permission.php文件

六、permission.php 文件的使用和说明

return [            'models' => [                                'permission' => Spatie\Permission\Models\Permission::class,                                'role'       => Spatie\Permission\Models\Role::class,],            'table_names' => [                                'roles'       => 'roles',                                'permissions' => 'permissions',                                'model_has_permissions' => 'model_has_permissions',                                'model_has_roles'       => 'model_has_roles',                                'role_has_permissions'  => 'role_has_permissions',            ],            'column_names' => [                                'model_morph_key' => 'model_id',            ],                        'display_permission_in_exception' => false,            'cache' => [                                'expiration_time' => \DateInterval::createFromDateString('24 hours'),                                'key' => 'spatie.permission.cache',                                'model_key' => 'name',                                'store' => 'default',            ],        ];

七、在user模型下加载角色相关信息

use HasRoles;

八、测试角色、权限

#新建一个控制器php artisan make:controller IndexController

 控制器的内容如下：

 '张三', 'mobile' => '13666666666', 'password' => '123',],            ['name' => '李四', 'mobile' => '13888888888', 'password' => '123',],        ];        //添加用户        $userInfo = User::insert( $userData );        //添加角色        $roleData = [            ['name' => '作家',],            ['name' => '读者'],        ];        foreach($roleData as $roleValue){            $role = Role::create( $roleValue );        }        //添加权限        $permissionData = [            ['name' => '新增文章'],            ['name' => '编辑文章'],            ['name' => '查看文章'],            ['name' => '删除文章'],        ];        foreach($permissionData as $permissionValue){            $permission = Permission::create( $permissionValue );        }        echo 'ok';        die;    }    //测试：给用户添加角色    private static function userAddRole()    {        //执行完此步骤，表[model_has_roles]会多一条数据，model_type=App\User：就代表是用户 role_id：角色id model_id：用户id        $user = User::find( 1 );        $res  = $user->assignRole( '作家' );        print_r( $res );    }    //测试：给角色添加权限    private static function roleAddPermission()    {                $role = Role::find( 1 );        //$res = $role->givePermissionTo('新增文章');        //print_r($res);die;                $permission = Permission::find( 2 );        //$res = $permission->assignRole($role);        //print_r($res);die;                $permission    = Permission::whereIn( 'id', [1, 2] )->get();        $allPermission = $role->syncPermissions( $permission );    }    //测试：给用户添加权限    private static function userAddPermission()    {        //执行完此步骤，表[model_has_permission]会多一条数据，model_type=App\User：就代表是用户        $user              = User::find( 1 );        $addUserPermission = $user->givePermissionTo( '新增文章' );        print_r( $addUserPermission );    }}

九、有关用户、角色、权限方法的使用

$cachePermission = Cache::get('spatie.permission.cache');$role = Role::find(1);$deleteRes = $role->revokePermissionTo('查看文章');print_r($deleteRes->toArray());//从角色中删除权限：方式2（通过权限删除）$permission = Permission::find(4);$deleteRes = $permission->removeRole($role);print_r($deleteRes->toArray());$user = User::find( 1 );//获取某个用户的所有权限$permissions = $user->permissions;print_r($permissions->toArray());//获取用户通过角色继承的所有权限$permissions = $user->getAllPermissions();print_r($permissions->toArray());//获取某个用户的所有角色$roles = $user->getRoleNames();print_r($roles);//仅返回具有角色 '作家' 的用户 $user = User::role( '作家' )->get();print_r($user->toArray());//仅返回具有 '新增文章'（继承或直接）权限的用户$user = User::permission( '新增文章' )->get();print_r($user->toArray());//可以撤销用户权限$user->revokePermissionTo('新增文章');//或者一次性撤消并添加新的权限$user->syncPermissions(['新增文章', '删除文章']);//测试用户是否拥有权限$user->hasPermissionTo('新增文章');//或者可以传递一个代表权限 ID 的整数$user->hasPermissionTo(1);$user->hasPermissionTo(Permission::find(1)->id);$user->hasPermissionTo($somePermission->id);//同时校验用户是否拥有多个权限（通过权限 名称 校验）$user->hasAnyPermission(['新增文章', '编辑文章', '删除文章']);//同时校验用户是否同时拥有多个权限（通过权限 ID 校验）$user->hasAnyPermission(['新增文章', 2, 4]);//校验用户是否具有某个角色$user->hasRole('作家');//还可以确定用户是否具有任何给定的角色列表$user->hasAnyRole(Role::all());//还可以确定用户是否具有所有给定的角色列表$user->hasAllRoles(Role::all());//可以给角色一个许可$role->givePermissionTo('编辑文章');//确定角色是否具有某种权限$role->hasPermissionTo('编辑文章');//角色撤销权限$role->revokePermissionTo('编辑文章');//权限是从角色自动继承的。 当让，个人权限也可以分配给用户$role = Role::findByName('作家');$role->givePermissionTo('编辑文章');$user->assignRole('作家');$user->givePermissionTo('删除文章');在上面的示例中，角色被授予编辑文章的权限，并且该角色被分配给用户。 现在，用户可以编辑文章并删除文章。 ‘删除文章’ 的权限是用户的直接许可，因为它直接分配给他们。当我们调用 $user->hasDirectPermission('删除文章') 时，它会返回 true而对 $user->hasDirectPermission('编辑文章') 返回 false。//如果你为应用程序中的角色和用户构建权限并希望限制或更改用户角色的继承权限（即仅允许更改用户的直接权限），则此方法非常有用。//直接权限$user->getDirectPermissions(); 或者使用 $user->permissions//从用户角色继承的权限$user->getPermissionsViaRoles();//适用于用户的所有权限（继承和直接）$user->getAllPermissions();所有这些响应都是 Spatie\Permission\Models\Permission 对象的集合。

十、权限中间件的使用

laravel-permission扩展附带 RoleMiddleware 和 PermissionMiddleware 中间件。 你可以将它们添加到你的 app/Http/Kernel.php 文件中。

'role' => \Spatie\Permission\Middlewares\RoleMiddleware::class,'permission' => \Spatie\Permission\Middlewares\PermissionMiddleware::class,

然后，你可以使用中间件规则保护你的路由：

#例如Route::group(['middleware' => ['role:super-admin']], function () { // });Route::group(['middleware' => ['permission:删除文章']], function () { // });Route::group(['middleware' => ['role:super-admin','permission:删除文章']], function () { // });或者，您可以用 |（管道）字符分隔多个角色或权限Route::group(['middleware' => ['role:super-admin|作家']], function () { // });Route::group(['middleware' => ['permission:新增文章|编辑文章']], function () { // });

通过在构造函数中设置所需的中间件，可以同样保护您的控制器

public function __construct(){   $this->middleware( ['role:超级管理员', 'permission:删除文章|编辑文章'] );}

十一、使用 artisan 命令操作权限

可以使用 artisan 命令从控制台创建角色或权限

php artisan permission:create-role 作家php artisan permission:create-permission "新增文章"

在为特定守卫创建权限和角色时，可以将守卫名称指定为第二个参数

php artisan permission:create-role 作家 webphp artisan permission:create-permission "新增文章" web

十二、权限缓存的使用

当你使用提供的方法来操作角色和权限时，缓存会自动为您重置

$user->assignRole('作家'); $user->removeRole('作家'); $user->syncRoles(params); $role->givePermissionTo('编辑文章'); $role->revokePermissionTo('编辑文章'); $role->syncPermissions(params); $permission->assignRole('作家'); $permission->removeRole('作家'); $permission->syncRoles(params);

但是，如果直接在数据库中操作“权限/角色”数据而不是调用提供的方法，则除非手动重置缓存，否则不会在应用程序中看到反映的更改。

要手动重置此软件包的缓存，请运行：

php artisan cache:forget spatie.permission.cache

来源地址：https://blog.csdn.net/wplblog/article/details/128574376