首页 » Web技术 » Laravel » 正文

使用Laravel5.1自带权限控制系统 ACL

Laravel在5.1.11版本中加入了Authorization,可以让用户自定义权限,今天分享一种定义权限系统的方法。

1. 创建角色与权限表

使用命令行创建角色与权限表:

php artisan make:migration create_permissions_and_roles --create=permissions

之后打开刚刚创建的文件,填入下面的代码:

public function up()
{
    Schema::create('roles', function (Blueprint $table) {
        $table->increments('id');
        $table->string('name');
        $table->string('label');
        $table->string('description')->nullable();
        $table->timestamps();
    });

    Schema::create('permissions', function (Blueprint $table) {
        $table->increments('id');
        $table->string('name');
        $table->string('label');
        $table->string('description')->nullable();
        $table->timestamps();
    });

    Schema::create('permission_role', function (Blueprint $table) {
        $table->integer('permission_id')->unsigned();
        $table->integer('role_id')->unsigned();

        $table->foreign('permission_id')
              ->references('id')
              ->on('permissions')
              ->onDelete('cascade');

        $table->foreign('role_id')
              ->references('id')
              ->on('roles')
              ->onDelete('cascade');

        $table->primary(['permission_id', 'role_id']);
    });

    Schema::create('role_user', function (Blueprint $table) {
        $table->integer('user_id')->unsigned();
        $table->integer('role_id')->unsigned();

        $table->foreign('role_id')
              ->references('id')
              ->on('roles')
              ->onDelete('cascade');

        $table->foreign('user_id')
              ->references('id')
              ->on('users')
              ->onDelete('cascade');

        $table->primary(['role_id', 'user_id']);
    });
}

public function down()
{
    Schema::drop('roles');
    Schema::drop('permissions');
    Schema::drop('permission_role');
    Schema::drop('role_user');
}

上面的代码会创建角色表、权限表、角色与权限的中间表以及角色与用户的中间表。

2. 创建模型

接下来使用命令行分别创建角色与权限模型:

php artisan make:model Permission
php artisan make:model Role

然后分别打开Permission.php、Role.php 以及 User.php ,加入下面的代码:

// Permissions.php
public function roles()
{
    return $this->belongsToMany(Role::class);
}


// Role.php
public function permissions()
{
    return $this->belongsToMany(Permission::class);
}
//给角色添加权限
public function givePermissionTo($permission)
{
    return $this->permissions()->save($permission);
}

// User.php
public function roles()
{
    return $this->belongsToMany(Role::class);
}
// 判断用户是否具有某个角色
public function hasRole($role)
{
    if (is_string($role)) {
        return $this->roles->contains('name', $role);
    }

    return !! $role->intersect($this->roles)->count();
}
// 判断用户是否具有某权限
public function hasPermission($permission)
{
    return $this->hasRole($permission->roles);
}
// 给用户分配角色
public function assignRole($role)
{
    return $this->roles()->save(
        Role::whereName($role)->firstOrFail()
    );
}

上面的代码实现了给角色分配权限及给用户分配角色,然后还提供了判断用户是否具有某角色及某权限的方法。

之后就给使用Laravel提供的Authorization来定义权限控制了,打开 /app/Providers/AuthServiceProvider.php 文件,在 boot() 中添加代码:

    public function boot(GateContract $gate)
    {
        parent::registerPolicies($gate);

        $permissions = \App\Permission::with('roles')->get();
        foreach ($permissions as $permission) {
            $gate->define($permission->name, function($user) use ($permission) {
                return $user->hasPermission($permission);
            });
        }
    }

通过上面的方法就定义好了各个权限。下面就该填充数据了。

3. 填充数据

为方便起见,这里使用 tinker 命令行工具来添加几条测试数据:

php artisan tinker

之后进入命令行,依次输入下列命令:

// 改变命名空间位置,避免下面每次都要输入 App
namespace App

// 创建权限
$permission_edit = new Permission

$permission_edit->name = 'edit-post'

$permission_edit->label = 'Can edit post'

$permission_edit->save()

$permission_delete = new Permission

$permission_delete->name = 'delete-post'

$permission_delete->label = 'Can delete post'

$permission_delete->save()

// 创建角色
$role_editor = new Role

$role_editor->name = 'editor';

$role_editor->label = 'The editor of the site';

$role_editor->save()

$role_editor->givePermissionTo($permission_edit)

$role_admin = new Role

$role_admin->name = 'admin';

$role_admin->label = 'The admin of the site';

$role_admin->save()

// 给角色分配权限
$role_admin->givePermissionTo($permission_edit)

$role_admin->givePermissionTo($permission_delete)

// 创建用户
$editor = factory(User::class)->create()

// 给用户分配角色
$editor->assignRole($role_editor->name)

$admin = factory(User::class)->create()

$admin->assignRole($role_admin->name)

上面我们创建了两个权限:edit-postdelete-post,然后创建了 editoradmin 两个角色,editor 角色拥有 edit-post 的权限,而 admin 两个权限都有。之后生成了两个用户,分别给他们分配了 editoradmin 的角色,即:ID 1 用户拥有 editor 角色,因此只有 edit-post 权限,而 ID 2 用户拥有 admin 角色,因此具有 edit-postdelete-post 权限。下面我们来验证下是否正确。

打开 routes.php 文件:

Route::get('/', function () {
    $user = Auth::loginUsingId(1);
    return view('welcome');
})

上面我们先验证 ID 1 用户的权限,然后修改 /resources/views/welcome.blade.php 文件:

<!DOCTYPE html>
<html>
    <head>
        <title>Laravel</title>
    </head>
    <body>
        <h1>权限测试</h1>
        <p>
        @can('edit-post')
            <a href="#">Edit Post</a>
        @endcan
        </p>
        <p>
        @can('delete-post')
            <a href="#">Delete Post</a>
        @endcan
        </p>
    </body>
</html>

在视图中我们通过 Laravel 提供的 @can 方法来判断用户是否具有某权限。

打开浏览器,访问上面定义的路由,可以看到视图中只出现了 Edit Post 链接。之后我们修改路由中用户ID为 2 ,然后再次刷新浏览器,可以看到,这次同时出现了 Edit PostDelete Post 两个链接,说明我们定义的权限控制起作用了。

laravel-acl-test

(完)

本文共 64 个回复

  • miyaye 2017/01/16 14:20

    gate 只支持user表, 如果前后台用户表分离, 则不支持后台的用户表, 不知道可有解决方法

  • mico 2017/08/14 16:50

    如果有几百个权限要控制,有编辑,超级管理员,数据库管理员,审核人员多个用户,你准备在模版中@can几百几千次

    • Specs 2017/08/14 23:28

      @ mico 对于比较大的系统当然还是使用一些专门的包合适了

  • admin 2017/12/07 18:18

    哥们,我现在就是用的你这个,很不错。但是有个疑问,我要重新分配权限的时候,我需要把以前的权限全部删除掉,然后重新插入permission_role这个表,我感觉这个不是很合理,你是怎么做的呢?

    • Specs 2017/12/10 09:32

      @ admin $user->permission()->sync([1,2,3]) 通过 sync 命令可以简单的实现这个功能

      • admin 2017/12/11 11:00

        @ Specs 版主你好,还有几个问题想请教下:1、怎么获取一个角色的所有权限呢?2、这个是一个用户对应一个角色,还是说一个用户可对应多个角色?我想做的就是一个用户对应一个角色即可。谢谢啦!

      • admin 2017/12/11 11:01

        @ Specs 这个1,2,3表示的是权限id吗?不能直接传入权限名么?

      • admin 2017/12/11 11:08

        @ Specs 我是要给角色分配权限,我把$user改成role模型,但是$role->permission()->sync([1,2,3]) 用这个报错了,BadMethodCallException in Builder.php line 2123:Call to undefined method Illuminate\Database\Query\Builder::permission()

123

发表评论