Info

Content

基于 Laravel Permission 扩展包在项目中轻松实现 RBAC 权限管理功能

Created 6 years ago by 学院君, Updated 4 years ago Revision #2 87833 views 23 likes 2 collects

一直想整理出一篇单独在 Laravel 中基于 RBAC 实现权限管理的教程，今天总算是交上这份作业了，开始之前，先祭出最终用户权限管理的效果图镇场子：

用户权限管理的效果图

项目初始化

下面正式开始今天的作业，我们基于由 Spatie 维护的 Laravel Permission 扩展包来实现 RBAC 权限管理，Spatie 出品，必属精品。首先需要安装一个干净的 Laravel 项目，然后在项目根目录下通过 Composer 来安装扩展包依赖：

composer create-project laravel/laravel permission --prefer-dist
cd permission
composer require spatie/laravel-permission

创建数据表

先通过如下命令将扩展包提供的数据库迁移文件发布到 database/migrations 目录下：

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

然后不要忘了修改 .env 中的数据库配置以匹配本地数据库设置，完成这一步之后就可以运行下面的命令根据数据库迁移文件生成相应的数据表了：

php artisan migrate

数据库迁移

运行成功后查看数据库会发现新生成了如下数据表：

生成的数据表

配置文件

接下来将扩展包提供的权限配置文件 permission.php 发布到 config 目录下以便对默认配置进行修改：

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

其中主要包含了默认权限、角色模型类以及对应数据表配置，一般而言，保持默认配置即可。

模型类调整

在 User 模型类中使用 HasRoles trait 提供权限相关方法：

User 模型类中使用 HasRoles

安装 Laravel Collective HTML

我们通过 Composer 安装这个扩展包依赖以便后续构建视图页面所需表单：

composer require laravelcollective/html

基本使用

完成上述初始化工作后，接下来我们来看一下如何使用 Laravel Permission 扩展包提供的方法来实现一些基本操作。

我们可以通过以下方式创建新的角色和权限：

use Spatie\Permission\Models\Role;
use Spatie\Permission\Models\Permission;

$role = Role::create(['name' => 'writer']);
$permission = Permission::create(['name' => 'edit articles']);

通过调用用户实例上的动态属性 permissions 获取用户所有权限：

$permissions = $user->permissions;

通过 pluck 方法获取用户角色名称：

$roles = $user->roles()->pluck('name');

还可以通过 Blade 指令验证登录用户是否拥有给定角色：

@role('writer')
    I'm a writer!
@else
    I'm not a writer...
@endrole

@hasrole('writer')
    I'm a writer!
@else
    I'm not a writer...
@endhasrole

@hasanyrole(Role::all())
    I have one or more of these roles!
@else
    I have none of these roles...
@endhasanyrole

@hasallroles(Role::all())
    I have all of these roles!
@else
    I don't have all of these roles...
@endhasallroles

通过 @can 指令验证用户是否拥有给定权限：

@can('Edit Post')
    I have permission to edit
@endcan

使用实例

下面我们以为用户分配文章操作权限为例来演示如何在实践中使用 Laravel Permission 扩展包实现 RBAC 权限管理。首先我们通过如下 Artisan 命令生成用户认证相关脚手架代码：

php artisan make:auth

上述指令会生成用户登录注册所需的路由、控制器、视图等代码文件。我们需要对生成的代码做少许调整：

登录注册控制器调整

修改 RegisterController 控制器的 create 方法如下：

protected function create(array $data)
{
    return User::create([
        'name' => $data['name'],
        'email' => $data['email'],
        'password' => $data['password'],
    ]);
}

转而在 User 模型类中新增修改器方法以便在保存时对密码字段进行加密处理：

public function setPasswordAttribute($password) {
    $this->attributes['password'] = bcrypt($password);
}

修改 LoginController 和 RegisterController 控制器的 redirectTo 属性：

protected $redirectTo = '/';

布局视图文件调整

接下来编辑 resources/views/layouts/app.blade.php 模板文件，新增一个下拉「Admin」链接用于查看所有用户和错误文件，只有具备「Admin」角色的用户才可以看到此链接。此外，我们还创建了一个自定义的 styles.css 文件用于渲染 resources/views/posts/index.blade.php 视图样式：

<!DOCTYPE html>
<html lang="{{ config('app.locale') }}">
<head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">

    <!-- CSRF Token -->
    <meta name="csrf-token" content="{{ csrf_token() }}">

    <title>{{ config('app.name', 'Laravel') }}</title>

    <!-- Styles -->
    <link href="{{ asset('css/styles.css') }}" rel="stylesheet">

    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">

    <!-- Scripts -->
    <script>
        window.Laravel = {!! json_encode([
            'csrfToken' => csrf_token(),
        ]) !!};
    </script>
    <script src="https://use.fontawesome.com/9712be8772.js"></script>
</head>
<body>
    <div id="app">
        <nav class="navbar navbar-default navbar-static-top">
            <div class="container">
                <div class="navbar-header">

                    <!-- Collapsed Hamburger -->
                    <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#app-navbar-collapse">
                        <span class="sr-only">Toggle Navigation</span>
                        <span class="icon-bar"></span>
                        <span class="icon-bar"></span>
                        <span class="icon-bar"></span>
                    </button>

                    <!-- Branding Image -->
                    <a class="navbar-brand" href="{{ url('/') }}">
                        {{ config('app.name', 'Laravel') }}
                    </a>
                </div>

                <div class="collapse navbar-collapse" id="app-navbar-collapse">
                    <!-- 导航条左边 -->
                    <ul class="nav navbar-nav">
                        <li><a href="{{ url('/') }}">Home</a></li>
                        @if (!Auth::guest())
                            <li><a href="{{ route('posts.create') }}">New Article</a></li>
                         @endif
                    </ul>

                    <!-- 导航条右边 -->
                    <ul class="nav navbar-nav navbar-right">
                        <!-- 登录注册链接 -->
                        @if (Auth::guest())
                            <li><a href="{{ route('login') }}">Login</a></li>
                            <li><a href="{{ route('register') }}">Register</a></li>
                        @else
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">
                                    {{ Auth::user()->name }} <span class="caret"></span>
                                </a>

                                <ul class="dropdown-menu" role="menu">
                                    <li>
                                        @role('Admin') {{-- Laravel-permission blade 辅助函数 --}}
                                        <a href="#"><i class="fa fa-btn fa-unlock"></i>Admin</a>
                                        @endrole
                                        <a href="{{ route('logout') }}" onclick="event.preventDefault(); document.getElementById('logout-form').submit();">
                                            Logout
                                        </a>

                                        <form id="logout-form" action="{{ route('logout') }}" method="POST" style="display: none;">
                                            {{ csrf_field() }}
                                        </form>
                                    </li>
                                </ul>
                            </li>
                        @endif
                    </ul>
                </div>
            </div>
        </nav>

        @if(Session::has('flash_message'))
            <div class="container">      
                <div class="alert alert-success"><em> {!! session('flash_message') !!}</em>
                </div>
            </div>
        @endif 

        <div class="row">
            <div class="col-md-8 col-md-offset-2">              
                @include ('errors.list') {{-- 引入错误文件 --}}
            </div>
        </div>

        @yield('content')

    </div>

    <!-- Scripts -->
    <script src="{{ asset('js/app.js') }}"></script>
</body>
</html>

创建错误文件视图模板文件 resources/views/errors/list.blade.php：

@if (count($errors) > 0)
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

编写 public/css/styles.css 文件内容如下：

p.teaser {
    text-indent: 30px; 
}

文章相关资源类

处理好布局视图文件后，接下来开始正式编码工作。首先创建文章模型类及其对应数据库迁移文件：

php artisan make:model Post -m

然后修改新生成的 CreatePostsTable 迁移类：

use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreatePostsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('posts', function (Blueprint $table) {
            $table->increments('id');
            $table->string('title');
            $table->text('body');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('posts');
    }
}

运行如下命令生成对应文章数据表：

php artisan migrate

编辑 Post 模型类以支持批量赋值：

class Post extends Model
{
    protected $fillable = ['title', 'body'];
}

接下来创建文章资源控制器：

php artisan make:controller PostController --resource

编写新生成的 PostController 代码如下：

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;

use App\Post;
use Auth;
use Session;

class PostController extends Controller {

    public function __construct() {
        $this->middleware(['auth', 'clearance'])->except('index', 'show');
    }

    /**
     * 显示文章列表
     *
     * @return \Illuminate\Http\Response
     */
    public function index() {
        $posts = Post::orderby('id', 'desc')->paginate(5); //show only 5 items at a time in descending order

        return view('posts.index', compact('posts'));
    }

    /**
     * 显示创建文章表单
     *
     * @return \Illuminate\Http\Response
     */
    public function create() {
        return view('posts.create');
    }

    /**
     * 存储新增文章
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request) {

        //验证 title 和 body 字段
        $this->validate($request, [
            'title'=>'required|max:100',
            'body' =>'required',
        ]);

        $title = $request['title'];
        $body = $request['body'];

        $post = Post::create($request->only('title', 'body'));

        // 基于保存结果显示成功消息
        return redirect()->route('posts.index')
            ->with('flash_message', 'Article,
             '. $post->title.' created');
    }

    /**
     * 显示指定资源
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function show($id) {
        $post = Post::findOrFail($id); //通过 id = $id 查找文章

        return view ('posts.show', compact('post'));
    }

    /**
     * 显示编辑文章表单
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function edit($id) {
        $post = Post::findOrFail($id);

        return view('posts.edit', compact('post'));
    }

    /**
     * 更新文章
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, $id) {
        $this->validate($request, [
            'title'=>'required|max:100',
            'body'=>'required',
        ]);

        $post = Post::findOrFail($id);
        $post->title = $request->input('title');
        $post->body = $request->input('body');
        $post->save();

        return redirect()->route('posts.show',
            $post->id)->with('flash_message',
            'Article, '. $post->title.' updated');

    }

    /**
     * 删除文章
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function destroy($id) {
        $post = Post::findOrFail($id);
        $post->delete();

        return redirect()->route('posts.index')
            ->with('flash_message',
                'Article successfully deleted');

    }
}

最后注册相应路由到 app/routes/web.php：

Route::get('/', 'PostController@index')->name('home');
Route::resource('posts', 'PostController');

根据 PostController 控制器提供的方法，需要创建四个相应视图：resources\views\posts\index.blade.php、resources\views\posts\create.blade.php、resources\views\posts\show.blade.php 和 \resources\views\posts\edit.blade.php。

编写 index.blade.php 代码如下：

@extends('layouts.app')
@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-10 col-md-offset-1">
                <div class="panel panel-default">
                    <div class="panel-heading"><h3>Posts</h3></div>
                    <div class="panel-heading">Page {{ $posts->currentPage() }} of {{ $posts->lastPage() }}</div>
                    @foreach ($posts as $post)
                        <div class="panel-body">
                            <li style="list-style-type:disc">
                                <a href="{{ route('posts.show', $post->id ) }}"><b>{{ $post->title }}</b><br>
                                    <p class="teaser">
                                       {{  str_limit($post->body, 100) }} {{-- Limit teaser to 100 characters --}}
                                    </p>
                                </a>
                            </li>
                        </div>
                    @endforeach
                    </div>
                    <div class="text-center">
                        {!! $posts->links() !!}
                    </div>
                </div>
            </div>
        </div>
@endsection

编写 create.blade.php 代码如下：

@extends('layouts.app')

@section('title', '| Create New Post')

@section('content')
    <div class="row">
        <div class="col-md-8 col-md-offset-2">

        <h1>Create New Post</h1>
        <hr>

    {{-- 使用 Laravel HTML Form Collective 创建表单 --}}
        {{ Form::open(array('route' => 'posts.store')) }}

        <div class="form-group">
            {{ Form::label('title', 'Title') }}
            {{ Form::text('title', null, array('class' => 'form-control')) }}
            <br>

            {{ Form::label('body', 'Post Body') }}
            {{ Form::textarea('body', null, array('class' => 'form-control')) }}
            <br>

            {{ Form::submit('Create Post', array('class' => 'btn btn-success btn-lg btn-block')) }}
            {{ Form::close() }}
        </div>
        </div>
    </div>

@endsection

编写 show.blade.php 代码如下：

@extends('layouts.app')

@section('title', '| View Post')

@section('content')

<div class="container">

    <h1>{{ $post->title }}</h1>
    <hr>
    <p class="lead">{{ $post->body }} </p>
    <hr>
    {!! Form::open(['method' => 'DELETE', 'route' => ['posts.destroy', $post->id] ]) !!}
    <a href="{{ url()->previous() }}" class="btn btn-primary">Back</a>
    @can('Edit Post')
    <a href="{{ route('posts.edit', $post->id) }}" class="btn btn-info" role="button">Edit</a>
    @endcan
    @can('Delete Post')
    {!! Form::submit('Delete', ['class' => 'btn btn-danger']) !!}
    @endcan
    {!! Form::close() !!}

</div>

@endsection

最后，编写 edit.blade.php 代码如下：

@extends('layouts.app')

@section('title', '| Edit Post')

@section('content')
<div class="row">

    <div class="col-md-8 col-md-offset-2">

        <h1>Edit Post</h1>
        <hr>
            {{ Form::model($post, array('route' => array('posts.update', $post->id), 'method' => 'PUT')) }}
            <div class="form-group">
            {{ Form::label('title', 'Title') }}
            {{ Form::text('title', null, array('class' => 'form-control')) }}<br>

            {{ Form::label('body', 'Post Body') }}
            {{ Form::textarea('body', null, array('class' => 'form-control')) }}<br>

            {{ Form::submit('Save', array('class' => 'btn btn-primary')) }}

            {{ Form::close() }}
    </div>
    </div>
</div>

@endsection

完成上述工作后，再次访问项目首页，页面显示如下：

效果图

用户相关资源类

用户对应模型类和数据表已存在，所以我们直接从创建资源控制器开始：

php artisan make:controller UserController --resource

编写刚生成的 UserController 代码如下：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\User;
use Auth;
// 引入 laravel-permission 模型
use Spatie\Permission\Models\Role;
use Spatie\Permission\Models\Permission;
// 用于输出一次性信息
use Session;

class UserController extends Controller {

    public function __construct() {
        $this->middleware(['auth', 'isAdmin']); // isAdmin 中间件让具备指定权限的用户才能访问该资源
    }

    /**
     * 显示用户列表
     *
     * @return \Illuminate\Http\Response
     */
    public function index() {
    //Get all users and pass it to the view
        $users = User::all(); 
        return view('users.index')->with('users', $users);
    }

    /**
     * 显示创建用户角色表单
     *
     * @return \Illuminate\Http\Response
     */
    public function create() {
        // 获取所有角色并将其传递到视图
        $roles = Role::get();
        return view('users.create', ['roles'=>$roles]);
    }

    /**
     * 在数据库中保存新创建的资源
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request) {
        // 验证 name、email 和 password 字段
        $this->validate($request, [
            'name'=>'required|max:120',
            'email'=>'required|email|unique:users',
            'password'=>'required|min:6|confirmed'
        ]);

        $user = User::create($request->only('email', 'name', 'password')); //只获取 email、name、password 字段

        $roles = $request['roles']; // 获取输入的角色字段
        // 检查是否某个角色被选中
        if (isset($roles)) {
            foreach ($roles as $role) {
                $role_r = Role::where('id', '=', $role)->firstOrFail();            
                $user->assignRole($role_r); //Assigning role to user
            }
        }        
        // 重定向到 users.index 视图并显示消息
        return redirect()->route('users.index')
            ->with('flash_message',
             'User successfully added.');
    }

    /**
     * 显示指定用户
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function show($id) {
        return redirect('users'); 
    }

    /**
     * 显示编辑用户角色表单
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function edit($id) {
        $user = User::findOrFail($id); // 通过给定id获取用户
        $roles = Role::get(); // 获取所有角色

        return view('users.edit', compact('user', 'roles')); // 将用户和角色数据传递到视图

    }

    /**
     * 更新数据库中的给定用户
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, $id) {
        $user = User::findOrFail($id); // 通过id获取给定角色

        // 验证 name, email 和 password 字段
        $this->validate($request, [
            'name'=>'required|max:120',
            'email'=>'required|email|unique:users,email,'.$id,
            'password'=>'required|min:6|confirmed'
        ]);
        $input = $request->only(['name', 'email', 'password']); // 获取 name, email 和 password 字段
        $roles = $request['roles']; // 获取所有角色
        $user->fill($input)->save();

        if (isset($roles)) {        
            $user->roles()->sync($roles);  // 如果有角色选中与用户关联则更新用户角色
        } else {
            $user->roles()->detach(); // 如果没有选择任何与用户关联的角色则将之前关联角色解除
        }
        return redirect()->route('users.index')
            ->with('flash_message',
             'User successfully edited.');
    }

    /**
     * 删除用户
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function destroy($id) {
        // 通过给定id获取并删除用户
        $user = User::findOrFail($id); 
        $user->delete();

        return redirect()->route('users.index')
            ->with('flash_message',
             'User successfully deleted.');
    }
}

注册相应路由到 app/routes/web.php：

Route::resource('users', 'UserController');

根据 UserController 控制器提供的方法需要新增三个对应视图：resources\views\users\index.blade.php、resources\views\users\create.blade.php、resources\views\users\edit.blade.php。

编写 index.blade.php 视图代码如下：

@extends('layouts.app')

@section('title', '| Users')

@section('content')

<div class="col-lg-10 col-lg-offset-1">
    <h1><i class="fa fa-users"></i> User Administration <a href="{{ route('roles.index') }}" class="btn btn-default pull-right">Roles</a>
    <a href="{{ route('permissions.index') }}" class="btn btn-default pull-right">Permissions</a></h1>
    <hr>
    <div class="table-responsive">
        <table class="table table-bordered table-striped">

            <thead>
                <tr>
                    <th>Name</th>
                    <th>Email</th>
                    <th>Date/Time Added</th>
                    <th>User Roles</th>
                    <th>Operations</th>
                </tr>
            </thead>

            <tbody>
                @foreach ($users as $user)
                <tr>

                    <td>{{ $user->name }}</td>
                    <td>{{ $user->email }}</td>
                    <td>{{ $user->created_at->format('F d, Y h:ia') }}</td>
                    <td>{{  $user->roles()->pluck('name')->implode(' ') }}</td>{{-- Retrieve array of roles associated to a user and convert to string --}}
                    <td>
                    <a href="{{ route('users.edit', $user->id) }}" class="btn btn-info pull-left" style="margin-right: 3px;">Edit</a>

                    {!! Form::open(['method' => 'DELETE', 'route' => ['users.destroy', $user->id] ]) !!}
                    {!! Form::submit('Delete', ['class' => 'btn btn-danger']) !!}
                    {!! Form::close() !!}

                    </td>
                </tr>
                @endforeach
            </tbody>

        </table>
    </div>

    <a href="{{ route('users.create') }}" class="btn btn-success">Add User</a>

</div>

@endsection

编写 create.blade.php 视图代码如下：

@extends('layouts.app')

@section('title', '| Add User')

@section('content')

<div class='col-lg-4 col-lg-offset-4'>

    <h1><i class='fa fa-user-plus'></i> Add User</h1>
    <hr>

    {{ Form::open(array('url' => 'users')) }}

    <div class="form-group">
        {{ Form::label('name', 'Name') }}
        {{ Form::text('name', '', array('class' => 'form-control')) }}
    </div>

    <div class="form-group">
        {{ Form::label('email', 'Email') }}
        {{ Form::email('email', '', array('class' => 'form-control')) }}
    </div>

    <div class='form-group'>
        @foreach ($roles as $role)
            {{ Form::checkbox('roles[]',  $role->id ) }}
            {{ Form::label($role->name, ucfirst($role->name)) }}<br>

        @endforeach
    </div>

    <div class="form-group">
        {{ Form::label('password', 'Password') }}<br>
        {{ Form::password('password', array('class' => 'form-control')) }}

    </div>

    <div class="form-group">
        {{ Form::label('password', 'Confirm Password') }}<br>
        {{ Form::password('password_confirmation', array('class' => 'form-control')) }}

    </div>

    {{ Form::submit('Add', array('class' => 'btn btn-primary')) }}

    {{ Form::close() }}

</div>

@endsection

编写 edit.blade.php 视图代码如下：

@extends('layouts.app')

@section('title', '| Edit User')

@section('content')

<div class='col-lg-4 col-lg-offset-4'>

    <h1><i class='fa fa-user-plus'></i> Edit {{$user->name}}</h1>
    <hr>

    {{ Form::model($user, array('route' => array('users.update', $user->id), 'method' => 'PUT')) }}{{-- Form model binding to automatically populate our fields with user data --}}

    <div class="form-group">
        {{ Form::label('name', 'Name') }}
        {{ Form::text('name', null, array('class' => 'form-control')) }}
    </div>

    <div class="form-group">
        {{ Form::label('email', 'Email') }}
        {{ Form::email('email', null, array('class' => 'form-control')) }}
    </div>

    <h5><b>Give Role</b></h5>

    <div class='form-group'>
        @foreach ($roles as $role)
            {{ Form::checkbox('roles[]',  $role->id, $user->roles ) }}
            {{ Form::label($role->name, ucfirst($role->name)) }}<br>

        @endforeach
    </div>

    <div class="form-group">
        {{ Form::label('password', 'Password') }}<br>
        {{ Form::password('password', array('class' => 'form-control')) }}

    </div>

    <div class="form-group">
        {{ Form::label('password', 'Confirm Password') }}<br>
        {{ Form::password('password_confirmation', array('class' => 'form-control')) }}

    </div>

    {{ Form::submit('Add', array('class' => 'btn btn-primary')) }}

    {{ Form::close() }}

</div>

@endsection

至此，用户相关控制器和视图已编写完毕，下面来看权限相关资源类。

权限相关资源类

权限对应模型和数据表也已经存在了，所以只需通过以下命令创建权限资源控制器：

php artisan make:controller PermissionController --resource

编写 PermissionController 控制器代码如下：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use Auth;

// 引入 laravel-permission 模型
use Spatie\Permission\Models\Role;
use Spatie\Permission\Models\Permission;

use Session;

class PermissionController extends Controller {

    public function __construct() {
        $this->middleware(['auth', 'isAdmin']); // isAdmin 中间件让具备指定权限的用户才能访问该资源

    }

    /**
     * 显示权限列表
     *
     * @return \Illuminate\Http\Response
     */
    public function index() {
        $permissions = Permission::all(); // 获取所有权限

        return view('permissions.index')->with('permissions', $permissions);
    }

    /**
     * 显示创建权限表单
     *
     * @return \Illuminate\Http\Response
     */
    public function create() {
        $roles = Role::get(); // 获取所有角色

        return view('permissions.create')->with('roles', $roles);
    }

    /**
     * 保存新创建的权限
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request) {
        $this->validate($request, [
            'name'=>'required|max:40',
        ]);

        $name = $request['name'];
        $permission = new Permission();
        $permission->name = $name;

        $roles = $request['roles'];

        $permission->save();

        if (!empty($request['roles'])) { // 如果选择了角色
            foreach ($roles as $role) {
                $r = Role::where('id', '=', $role)->firstOrFail(); // 将输入角色和数据库记录进行匹配

                $permission = Permission::where('name', '=', $name)->first(); // 将输入权限与数据库记录进行匹配
                $r->givePermissionTo($permission);
            }
        }

        return redirect()->route('permissions.index')
            ->with('flash_message',
             'Permission'. $permission->name.' added!');

    }

    /**
     * 显示给定权限
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function show($id) {
        return redirect('permissions');
    }

    /**
     * 显示编辑权限表单
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function edit($id) {
        $permission = Permission::findOrFail($id);

        return view('permissions.edit', compact('permission'));
    }

    /**
    * 更新指定权限
    *
    * @param  \Illuminate\Http\Request  $request
    * @param  int  $id
    * @return \Illuminate\Http\Response
    */
    public function update(Request $request, $id) {
        $permission = Permission::findOrFail($id);
        $this->validate($request, [
            'name'=>'required|max:40',
        ]);
        $input = $request->all();
        $permission->fill($input)->save();

        return redirect()->route('permissions.index')
            ->with('flash_message',
             'Permission'. $permission->name.' updated!');

    }

    /**
     * 删除给定权限
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function destroy($id) {
        $permission = Permission::findOrFail($id);

        // 让特定权限无法删除 
        if ($permission->name == "Administer roles & permissions") {
            return redirect()->route('permissions.index')
            ->with('flash_message',
             'Cannot delete this Permission!');
        }

        $permission->delete();

        return redirect()->route('permissions.index')
            ->with('flash_message',
             'Permission deleted!');

    }
}

注册相应路由到 app/routes/web.php：

Route::resource('permissions', 'PermissionController');

根据 PermissionController 控制器提供的方法，需要创建三个对应视图文件。

首先创建 resources/views/permissions/index.blade.php 文件：

@extends('layouts.app')

@section('title', '| Permissions')

@section('content')

<div class="col-lg-10 col-lg-offset-1">
    <h1><i class="fa fa-key"></i>Available Permissions

    <a href="{{ route('users.index') }}" class="btn btn-default pull-right">Users</a>
    <a href="{{ route('roles.index') }}" class="btn btn-default pull-right">Roles</a></h1>
    <hr>
    <div class="table-responsive">
        <table class="table table-bordered table-striped">

            <thead>
                <tr>
                    <th>Permissions</th>
                    <th>Operation</th>
                </tr>
            </thead>
            <tbody>
                @foreach ($permissions as $permission)
                <tr>
                    <td>{{ $permission->name }}</td> 
                    <td>
                    <a href="{{ URL::to('permissions/'.$permission->id.'/edit') }}" class="btn btn-info pull-left" style="margin-right: 3px;">Edit</a>

                    {!! Form::open(['method' => 'DELETE', 'route' => ['permissions.destroy', $permission->id] ]) !!}
                    {!! Form::submit('Delete', ['class' => 'btn btn-danger']) !!}
                    {!! Form::close() !!}

                    </td>
                </tr>
                @endforeach
            </tbody>
        </table>
    </div>

    <a href="{{ URL::to('permissions/create') }}" class="btn btn-success">Add Permission</a>

</div>

@endsection

接下来创建 resources/views/permissions/create.blade.php 视图文件：

@extends('layouts.app')

@section('title', '| Create Permission')

@section('content')

<div class='col-lg-4 col-lg-offset-4'>

    <h1><i class='fa fa-key'></i> Add Permission</h1>
    <br>

    {{ Form::open(array('url' => 'permissions')) }}

    <div class="form-group">
        {{ Form::label('name', 'Name') }}
        {{ Form::text('name', '', array('class' => 'form-control')) }}
    </div><br>
    @if(!$roles->isEmpty()) //If no roles exist yet
        <h4>Assign Permission to Roles</h4>

        @foreach ($roles as $role) 
            {{ Form::checkbox('roles[]',  $role->id ) }}
            {{ Form::label($role->name, ucfirst($role->name)) }}<br>

        @endforeach
    @endif
    <br>
    {{ Form::submit('Add', array('class' => 'btn btn-primary')) }}

    {{ Form::close() }}

</div>

@endsection

最后创建 resources/views/permissions/edit.blade.php 视图文件：

@extends('layouts.app')

@section('title', '| Edit Permission')

@section('content')

<div class='col-lg-4 col-lg-offset-4'>

    <h1><i class='fa fa-key'></i> Edit {{$permission->name}}</h1>
    <br>
    {{ Form::model($permission, array('route' => array('permissions.update', $permission->id), 'method' => 'PUT')) }}{{-- Form model binding to automatically populate our fields with permission data --}}

    <div class="form-group">
        {{ Form::label('name', 'Permission Name') }}
        {{ Form::text('name', null, array('class' => 'form-control')) }}
    </div>
    <br>
    {{ Form::submit('Edit', array('class' => 'btn btn-primary')) }}

    {{ Form::close() }}

</div>

@endsection

最后创建角色相关资源类。

角色相关资源类

和权限一样，对应模型类和数据表已经存在，所以也是从创建资源控制器开始：

php artisan make:controller RoleController --resource

编写刚生成的 RoleController 控制器代码如下：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Auth;
// 引入 laravel-permission 模型
use Spatie\Permission\Models\Role;
use Spatie\Permission\Models\Permission;
use Session;

class RoleController extends Controller {

    public function __construct() {
        $this->middleware(['auth', 'isAdmin']); // isAdmin 中间件让具备指定权限的用户才能访问该资源

    }

    /**
     * 显示角色列表
     *
     * @return \Illuminate\Http\Response
     */
    public function index() {
        $roles = Role::all();// 获取所有角色

        return view('roles.index')->with('roles', $roles);
    }

    /**
     * 显示创建角色表单
     *
     * @return \Illuminate\Http\Response
     */
    public function create() {
        $permissions = Permission::all();// 获取所有权限

        return view('roles.create', ['permissions'=>$permissions]);
    }

    /**
     * 保存新创建的角色
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request) {
        //验证 name 和 permissions 字段
        $this->validate($request, [
                'name'=>'required|unique:roles|max:10',
                'permissions' =>'required',
            ]
        );

        $name = $request['name'];
        $role = new Role();
        $role->name = $name;

        $permissions = $request['permissions'];

        $role->save();
        // 遍历选择的权限
        foreach ($permissions as $permission) {
            $p = Permission::where('id', '=', $permission)->firstOrFail(); 
            // 获取新创建的角色并分配权限
            $role = Role::where('name', '=', $name)->first(); 
            $role->givePermissionTo($p);
        }

        return redirect()->route('roles.index')
            ->with('flash_message',
             'Role'. $role->name.' added!'); 
    }

    /**
     * 显示指定角色
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function show($id) {
        return redirect('roles');
    }

    /**
     * 显示编辑角色表单
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function edit($id) {
        $role = Role::findOrFail($id);
        $permissions = Permission::all();

        return view('roles.edit', compact('role', 'permissions'));
    }

    /**
     * 更新角色
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, $id) {

        $role = Role::findOrFail($id); // 通过给定id获取角色
        // 验证 name 和 permission 字段
        $this->validate($request, [
            'name'=>'required|max:10|unique:roles,name,'.$id,
            'permissions' =>'required',
        ]);

        $input = $request->except(['permissions']);
        $permissions = $request['permissions'];
        $role->fill($input)->save();

        $p_all = Permission::all();//获取所有权限

        foreach ($p_all as $p) {
            $role->revokePermissionTo($p); // 移除与角色关联的所有权限            
        }

        foreach ($permissions as $permission) {
            $p = Permission::where('id', '=', $permission)->firstOrFail(); //从数据库中获取相应权限
            $role->givePermissionTo($p);  // 分配权限到角色
        }

        return redirect()->route('roles.index')
            ->with('flash_message',
             'Role'. $role->name.' updated!');
    }

    /**
     * 删除指定权限
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function destroy($id)
    {
        $role = Role::findOrFail($id);
        $role->delete();

        return redirect()->route('roles.index')
            ->with('flash_message',
             'Role deleted!');

    }
}

注册相应路由到 app/routes/web.php：

Route::resource('roles', 'RoleController');

根据上面的 RoleController 控制器，需要创建三个相应的视图文件。

首先创建 resources/views/roles/index.blade.php 视图文件：

@extends('layouts.app')

@section('title', '| Roles')

@section('content')

<div class="col-lg-10 col-lg-offset-1">
    <h1><i class="fa fa-key"></i> Roles

    <a href="{{ route('users.index') }}" class="btn btn-default pull-right">Users</a>
    <a href="{{ route('permissions.index') }}" class="btn btn-default pull-right">Permissions</a></h1>
    <hr>
    <div class="table-responsive">
        <table class="table table-bordered table-striped">
            <thead>
                <tr>
                    <th>Role</th>
                    <th>Permissions</th>
                    <th>Operation</th>
                </tr>
            </thead>

            <tbody>
                @foreach ($roles as $role)
                <tr>

                    <td>{{ $role->name }}</td>

                    <td>{{ str_replace(array('[',']','"'),'', $role->permissions()->pluck('name')) }}</td>{{-- Retrieve array of permissions associated to a role and convert to string --}}
                    <td>
                    <a href="{{ URL::to('roles/'.$role->id.'/edit') }}" class="btn btn-info pull-left" style="margin-right: 3px;">Edit</a>

                    {!! Form::open(['method' => 'DELETE', 'route' => ['roles.destroy', $role->id] ]) !!}
                    {!! Form::submit('Delete', ['class' => 'btn btn-danger']) !!}
                    {!! Form::close() !!}

                    </td>
                </tr>
                @endforeach
            </tbody>

        </table>
    </div>

    <a href="{{ URL::to('roles/create') }}" class="btn btn-success">Add Role</a>

</div>

@endsection

然后创建 resources/views/roles/create.blade.php 视图文件：

@extends('layouts.app')

@section('title', '| Add Role')

@section('content')

<div class='col-lg-4 col-lg-offset-4'>

    <h1><i class='fa fa-key'></i> Add Role</h1>
    <hr>

    {{ Form::open(array('url' => 'roles')) }}

    <div class="form-group">
        {{ Form::label('name', 'Name') }}
        {{ Form::text('name', null, array('class' => 'form-control')) }}
    </div>

    <h5><b>Assign Permissions</b></h5>

    <div class='form-group'>
        @foreach ($permissions as $permission)
            {{ Form::checkbox('permissions[]',  $permission->id ) }}
            {{ Form::label($permission->name, ucfirst($permission->name)) }}<br>

        @endforeach
    </div>

    {{ Form::submit('Add', array('class' => 'btn btn-primary')) }}

    {{ Form::close() }}

</div>

@endsection

最后创建 resources/views/roles/edit.blade.php 视图文件：

@extends('layouts.app')

@section('title', '| Edit Role')

@section('content')

<div class='col-lg-4 col-lg-offset-4'>
    <h1><i class='fa fa-key'></i> Edit Role: {{$role->name}}</h1>
    <hr>

    {{ Form::model($role, array('route' => array('roles.update', $role->id), 'method' => 'PUT')) }}

    <div class="form-group">
        {{ Form::label('name', 'Role Name') }}
        {{ Form::text('name', null, array('class' => 'form-control')) }}
    </div>

    <h5><b>Assign Permissions</b></h5>
    @foreach ($permissions as $permission)

        {{Form::checkbox('permissions[]',  $permission->id, $role->permissions ) }}
        {{Form::label($permission->name, ucfirst($permission->name)) }}<br>

    @endforeach
    <br>
    {{ Form::submit('Edit', array('class' => 'btn btn-primary')) }}

    {{ Form::close() }}    
</div>

@endsection

权限中间件

到这里还没有结束，我们在上面的控制器中有用到 isAdmin 和 clearance 中间件，下面需要来创建并注册这两个中间件。

首先创建 AdminMiddleware 中间件：

php artisan make:middleware AdminMiddleware

编写 AdminMiddleware 中间件代码如下：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;
use App\User;

class AdminMiddleware
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        $user = User::all()->count();
        if (!($user == 1)) {
            if (!Auth::user()->hasPermissionTo('Administer roles & permissions')) // 用户是否具备此权限
        {
                abort('401');
            }
        }

        return $next($request);
    }
}

该中间件的作用主要是用于判断指定用户是否具备管理员权限。通过上面的代码，可以看出系统的第一个用户默认是管理员，以防止第一个用户出现权限死锁的情况。

接下来创建另一个中间件 ClearanceMiddleware：

php artisan make:middleware ClearanceMiddleware

编写 ClearanceMiddleware 代码如下：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;

class ClearanceMiddleware {
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next) {
        if (Auth::user()->hasPermissionTo('Administer roles & permissions')) 
        {
            return $next($request);  // 管理员具备所有权限
        }

        if ($request->is('posts/create')) // 文章发布权限
        {
            if (!Auth::user()->hasPermissionTo('Create Post'))
            {
                abort('401');
            } 
            else {
                return $next($request);
            }
        }

        if ($request->is('posts/*/edit')) // 文章编辑权限
        {
            if (!Auth::user()->hasPermissionTo('Edit Post')) {
                abort('401');
            } else {
                return $next($request);
            }
        }

        if ($request->isMethod('Delete')) // 文章删除权限
        {
            if (!Auth::user()->hasPermissionTo('Delete Post')) {
                abort('401');
            }
            else
            {
                return $next($request);
            }
        }

        return $next($request);
    }
}

该中间件的主要作用是判断用户是否具备给定操作的权限。

将上述两个中间件注册到 app/Http/kernel.php 的 $routeMiddleware 属性中：

protected $routeMiddleware = [
    ... // 其他中间件
    'isAdmin' => AdminMiddleware::class,
    'clearance' => ClearanceMiddleware::class
];

最后我们为 401 状态码编写一个错误页面 resources\views\errors\401.blade.php：

@extends('layouts.app')

@section('content')
    <div class='col-lg-4 col-lg-offset-4'>
        <h1><center>401<br>
                ACCESS DENIED</center></h1>
    </div>

@endsection

至此，我们已经完成了所有的编码工作，接下来对上面编写的代码进行功能测试。

功能测试

根据前面的 isAdmin 中间件实现逻辑，系统第一个用户默认具备管理员权限，这样我们就可以通过这个用户创建必要的权限和角色。

在 http://permission.test/permissions 页面新增四个权限 —— Create Post、Edit Post、Delete Post 以及 Administer roles & permissions：

创建权限

接下来在 http://permission.test/roles 页面创建几个具备相应权限的角色：

创建角色

最后在 http://permission.test/users 页面将「Admin」角色分配给当前登录用户：

分配用户角色

分配成功之后在顶部导航下拉列表中就可以看到「Admin」选项了：

查看用户角色

现在，可以点击「New Article」链接发布新文章了：

测试用户权限

这表示我们已经成功给用户分配了权限。在文章详情页，该用户（管理员）也具备增删改所有权限：

查看用户权限

至此，我们基于 RBAC 实现权限管理的教程已经全部完结，是不是挺简单的？

Vote Vote Cancel

Collect Collect Cancel

Donate

71 Comments

应该是网络问题吧

isAdmin中间件里：


$user = User::all()->count();
if (!($user == 1)) { //如果数据库里用户总量不等于1
    if (!Auth::user()->hasPermissionTo('Administer roles & permissions')) //检查当前用户是否有“Admin...”权限

报错是因为你的数据库里不只有1个用户，而且没有Administer roles & permissions权限

如何设置超级管理员，意思是默认超级管理不需要进行设置权限. 如果给超级管理员设置权限，一旦设置出错了，其它人也没有设置全选的功能，那么这个时候超级管理员就GG了

我点 New Article连接出现这个问题

There is no permission named Administer roles & permissions for guard web.

这是什么意思我数据库permission表里是有的

In reply to #34

后台创建下这个权限吧：https://xueyuanjun.com/post/9389.html#toc_10 这几个权限都创建了吗

报错了，"Call to a member function hasPermissionTo() on null"，我登录了，也设置了这个权限，但是在中间件ClearanceMiddleware中出错了，打印Auth::user()为 null，我是用wamp跑的。。。

In reply to #36

Auth::user() 打印结果为 NULL，$request->all() 打印结果为 []

In reply to #37

是我把中间件注册错了

生成 migrate 的时候怎么少了2张表 users 表和 password_reset 表

In reply to #39

我是直接一张表都没有，好奇怪

登录后即可添加评论

通过 Sail 构建基于 Docker 的 Laravel 本地集成开发环境

通过 Homestead 构建基于 Vagrant 的 Laravel 本地集成开发环境

通过 Valet 在 Mac 系统构建轻量级 Laravel 本地集成开发环境

Mac 系统为 Valet 开发环境安装指定版本 MySQL

在 Mac/Windows 系统中使用 Laradock 搭建基于 Docker 的 Laravel 开发环境

使用 Laragon 在 Windows 中快速搭建 Laravel 本地开发环境

使用 Visual Studio Code 作为 Laravel 开发工具

创建并运行一个新的 Laravel 项目

Laravel 路由入门：路由定义、参数传递及路由命名

Laravel 路由分组规则：中间件、子域名、路由前缀和命名空间

Laravel 控制器：从 MVC 模式到资源控制器

路由进阶使用：模型绑定、兜底路由、频率限制和路由缓存

表单方法伪造与跨站请求伪造（CSRF）攻击防护

视图入门：Laravel 支持的视图格式以及在路由中的基本使用

Blade 模板引擎入门篇：数据渲染 & 控制结构

Blade 模板引擎进阶篇：模板继承 & 组件引入

Blade 模板引擎高级篇：View Composer & 自定义指令

在 Laravel 项目中使用 Bootstrap 框架

CSS 预编译语言 Sass 快速入门教程

在 Laravel 项目中编写第一个 Vue 组件

通过 Request 对象实例获取用户请求数据

基于 Laravel + Vue 组件实现文件异步上传

在 Laravel 控制器中进行表单请求字段验证

通过表单请求类实现请求字段验证和错误提示

通过匿名函数和验证规则类自定义字段验证规则

在 Laravel 中编写第一个 Artisan 命令

在 Laravel 中编写高级的 Artisan 命令

通过 Tinker 实现 Laravel 命令行交互式 Shell

入门篇（一）：数据库连接配置和读写分离

入门篇（二）：通过迁移文件定义数据表结构

入门篇（三）：通过填充器快速填充测试数据

入门篇（四）：通过查询构建器实现简单的增删改查操作

进阶篇（一）：通过查询构建器实现复杂的查询语句

进阶篇（二） —— 通过 Eloquent 模型实现简单增删改查操作

进阶篇（三）：通过 Eloquent 模型实现批量赋值和软删除

进阶篇（四）：在 Eloquent 模型类上设置访问器和修改器

进阶篇（五）：在 Eloquent 模型类上使用全局作用域和局部作用域进行查询

进阶篇（六）：Eloquent 模型事件和监听方式大全

进阶篇（七）：Eloquent 模型关联关系（上）

进阶篇（八）：Eloquent 模型关联关系（中）

进阶篇（九）：Eloquent 模型关联关系（下）

结合 Bootstrap + Vue 组件在 Laravel 中实现异步分页功能

在 Laravel 中通过自定义分页器分页方法实现伪静态分页链接以利于 SEO

基于 Laravel + Vue 构建一个类似 Twitter 的 Web 应用

使用 Entrust 扩展包在 Laravel 5 中实现 RBAC 权限管理（一）：安装配置篇

使用 Entrust 扩展包在 Laravel 5 中实现 RBAC 权限管理（二）：使用篇

基于 Laravel Permission 扩展包在项目中轻松实现 RBAC 权限管理功能

通过内置脚手架快速实现用户认证

用户注册登录流程及多字段登录实现

基于多表的用户认证功能实现（前后台用户）

通过 Passport 实现 API 请求认证：单页面应用篇

通过 Passport 实现 API 请求认证：移动端应用篇（密码授权令牌）

通过 Passport 实现 API 请求认证：第三方应用篇（授权码获取令牌）

通过 Passport 实现 API 请求认证：开放平台篇（客户端凭证令牌）

通过 Passport 实现 API 请求认证：沙箱测试篇（私人访问令牌）

通过 Passport 实现 API 请求认证：隐式授权令牌

通过 Passport 实现 API 请求认证：令牌作用域详解

通过 Laravel 内置脚手架快速实现邮箱验证功能

通过监听注册登录、邮箱验证事件实现简单的积分功能

通过 Cookie 实现基于 Session 的单点登录

基于 CAS 实现通用的单点登录解决方案（一）：CAS 原理及服务端搭建

基于 CAS 实现通用的单点登录解决方案（二）：CAS 客户端搭建及单点登录测试

基于 CAS 实现通用的单点登录解决方案（三）：用户单点退出实现

Laravel 底层是如何处理 HTTP 请求的

Laravel 请求类 Request 剖析

Laravel 响应类 Response 剖析

Laravel 中间件底层源码剖析

Laravel 路由匹配和执行底层源码剖析

异常处理篇之底层源码剖析

异常处理篇之异常信息报告、渲染及自定义处理

Laravel 框架如何基于 Composer 实现类和文件的自动加载

从基于 PHPUnit 编写单元测试开始

在 Laravel 中基于 PHPUnit 进行代码测试：目录结构及测试编排文件 phpunit.xml 详解

在 Laravel 中基于 PHPUnit 进行代码测试：单元测试篇

在 Laravel 中基于 PHPUnit 进行代码测试：HTTP 测试篇（上）

在 Laravel 中基于 PHPUnit 进行代码测试：HTTP 测试篇（下）

在 Laravel 中基于 Dusk 实现浏览器自动化测试快速入门

通过测试驱动开发构建待办任务项目（一）：后端接口和功能测试篇

通过测试驱动开发构建待办任务项目（二）：前端功能和浏览器测试篇

持续集成的定义和常用 CI 系统对比