Laravel--用户授权

1、简介

除了提供开箱即用的认证服务之外,Laravel 还提供了一个简单的方式来管理授权逻辑以便控制对资源的访问权限。和认证一样,在 Laravel 中实现授权很简单,主要有两种方式:gates 和 policies。可以将 gates 和 policies 分别看作路由和控制器,gates提供了简单的基于闭包的方式进行授权,而policies 和控制器一样,对特定模型或资源上的复杂授权逻辑进行分组,本着由简入繁的思路,我们首先来看 gates,然后再看 policies。不要将 gates 和 policies 看作互斥的东西,实际上,在大多数应用中我们会混合使用它们,这很有必要,因为 gates 通常用于与模型或资源无关的权限,比如访问管理后台,与之相反,policies 则用于对指定模型或资源的动作进行授权。

2、 Gate

编写Gates

Gates 是一个用于判断用户是否有权进行某项操作的闭包,通常使用 Gate门面定义在 App\Providers\AuthServiceProvider 类中。Gates 总是接收用户实例作为第一个参数,还可以接收相关的Eloquent 模型实例作为额外参数:

/** 
* 注册任意认证/授权服务. *
* @return void 
*/
public function boot()
{ 
      $this->registerPolicies(); 
      Gate::define('update-post', function ($user, $post){ 
            return $user->id == $post->user_id;
      });
}
授权动作

要使用 gates 授权某个动作,可以使用 allows或 denies 方法,需要注意的是你可以不传用户实例到这些方法,Laravel 会自动将用户实例传递到 gate 闭包:
<pre>
if (Gate::allows('update-post', $post))
{ // 当前用户可以更新文章...}
if (Gate::denies('update-post', $post))
{ // 当前用户不能更新文章...}
</pre>
如果你想要判断指定用户(非当前用户)是否有权进行某项操作,可以使用 Gate门面上的 forUser方法:
<pre>
if (Gate::forUser($user)->allows('update-post', $post))
{ // 当前用户可以更新文章...}
if (Gate::forUser($user)->denies('update-post', $post))
{ // 当前用户不能更新文章...}
</pre>

3、创建策略类

生成策略类

Policies(策略)是用于组织基于特定模型或资源的授权逻辑的类,例如,如果你开发的是一个博客应用,可以有一个 Post 模型和与之对应的 PostPolicy 来授权用户创建或更新博客的动作。我们使用 Artisan 命令 make:policy 来生成一个 policy(策略),生成的 policy 位于 app/Policies 目录下,如果这个目录之前不存在,Laravel 会为我们生成:
<pre>
php artisan make:policy PostPolicy
</pre>make:policy命令会生成一个空的 policy 类,如果你想要生成一个包含基本CRUD策略方法的 policy 类,在执行该命令的时候可以通过 --model指定相应模型:
<pre>
php artisan make:policy PostPolicy --model=Post
</pre>注:所有策略类都通过服务容器进行解析,以便在策略类的构造函数中通过类型提示进行依赖注入。

注册策略类

策略类创建之后,需要进行注册。Laravel 自带的 AuthServiceProvider包含了一个 policies属性来映射Eloquent 模型及与之对应的策略类。注册策略将会告知 Laravel 在授权给定模型动作时使用哪一个策略类:
<pre>
<?php
namespace App\Providers;
use App\Post;use App\Policies\PostPolicy;
use Illuminate\Support\Facades\Gate;
use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
class AuthServiceProvider extends ServiceProvider{
//应用的策略映射.
protected $policies = [ Post::class => PostPolicy::class, ];
//注册任意认证/授权服务.
public function boot() {
$this->registerPolicies();
}
}
</pre>

4、编写策略类

策略方法

策略类被注册后,还要为每个授权动作添加方法,例如,我们为用户更新 Post实例这一动作在 PostPolicy中定义一个 update方法。update方法会接收一个 User 实例和一个 Post 实例作为参数,并且返回 true 或 false以表明该用户是否有权限对给定 Post 进行更新。因此,在这个例子中,我们验证用户的 id 和文章对应的 user_id
是否匹配:
<pre>
<?php
namespace App\Policies;
use App\User;
use App\Post;
class PostPolicy{
//判断给定文章是否可以被用户更新.
public function update(User $user, Post $post)
{ return $user->id === $post->user_id; }
}
</pre>
你可以继续在策略类中为授权的权限定义更多需要的方法,例如,你可以定义 view 或者 delete 等方法来授多个 Post 动作,方法名不限。
注:如果你在使用 Artisan 命令生成策略类的时候使用了 --model 选项,那么策略类中就会包含了 view 、 create 、 update 和 delete 动作。

不带模型的方法

有些策略方法只接收当前认证的用户,并不接收授权的模型实例作为参数,这种用法在授权 create动作的时候很常见。例如,创建一篇博客的时候,你可能想要检查检查当前用户是否有权创建新博客。当定义不接收模型实例的策略方法时,例如 create方法,可以这么做:
<pre>
//判断当前用户是否可以创建文章.
public function create( User $user){ //}
</pre>

策略过滤器

对特定用户,你可能想要在一个策略方法中对其授权所有权限,比如后台管理员。要实现这个功能,需要在策略类中定义一个 before 方法, before 方法会在策略类的所有其他方法执行前执行,从而确保在其他策略方法调用前执行其中的逻辑:
<pre>
public function before($user, $ability){ if ($user->isSuperAdmin()) { return true; }}
</pre>
如果你想要禁止所有授权,可以在 before 方法中返回 false 。如果返回 null ,该授权会落入策略方法。

5、使用策略授权动作

通过User模型 Laravel 自带的 User 模型提供了两个方法用于授权动作: can 和 cant 。 can 方法接收你想要授权的动作和对应的模型作为参数。例如,下面的例子我们判断用户是否被授权更新给定的Post 模型:
<pre>
if ($user->can('update', $post)) { //}
</pre>
如果给定模型对应的策略已经注册,则 can 方法会自动调用相应的策略并返回布尔结果。如果给定模型没有何策略被注册, can 方法将会尝试调用与动作名称相匹配的Gate闭包。不依赖于模型的动作有些动作比如 create 并不需要依赖给定模型实例,在这些场景中,可以传递一个类名到 can方法,这个类名会在进行授权的时候用于判断使用哪一个策略:
<pre>
use App\Post;
if ($user->can('create', Post::class))
{ // Executes the "create" method on the relevant policy...}
</pre>
通过 中间件Laravel 提供了一个可以在请求到达路由或控制器之前进行授权的中间件—— Illuminate\Auth\Middleware\Authorize ,默认情况下,个中间件在 App\Http\Kernel 类中被分配了一个can 别名,下面我们来探究如何使用 can 中间件授权用户更新博客文章动作:
<pre>
use App\Post;
Route::put('/post/{post}', function (Post $post)
{ // The current user may update the post...})
->middleware('can:update,post');
</pre>
在这个例子中,我们传递了两个参数给 can 中间件,第一个是我们想要授权的动作名称,第二个是我们想要传递给策略方法的路由参数。在这个例子中,由于我们使用了隐式模型绑定,Post 模型将会被传递给策略方法,如果没有对用户进行给定动作的授权,中间件将会生成并返回一个状态码为 403 的 HTTP 响应。不依赖于模型的动作同样,对那些不需要传入模型实例的动作如 create ,需要传递类名到中间件,类名将会在授权动作的时候用于判断使用哪个策略:
<pre>
Route::post('/post', function () { // The current user may create posts...})->middleware('can:create,App\Post');
</pre>
通过控制器辅助函数除了提供给 User 模型的辅助函数,Laravel 还为继承自App\Http\Controllers\Controller
基类的所有控制器提供了 authorize 方法,和 can 方法类似,该方法接收你想要授权的动作名称以及相应模型实例作为参数,如果动作没有被授权, authorize 方法将会抛出 Illuminate\Auth\Access\AuthorizationException
,Laravel 默认异常处理器将会将其转化为状态码为 403 的 HTTP 响应:
<pre>
<?php
namespace App\Http\Controllers;
use App\Post;use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
class PostController extends Controller{
//更新给定博客文章.
public function update(Request $request, Post $post)
{ $this->authorize('update', $post); // The current user can update the blog post... }
}
</pre>
不依赖模型的动作和之前讨论的一样,类似 create 这样的动作不需要传入模型实例参数,在这些场景中,可以传递类名给 authorize 方法,该类名将会在授权动作时判断使用哪个策略:
<pre>
//创建一篇新的博客文章.
public function create(Request $request)
{ $this->authorize('create', Post::class); // The current user can create blog posts...}
</pre>
通过 Blade 模板编写 Blade 模板的时候,你可能想要在用户被授权特定动作的情况下才显示对应的视图模板部分,

例如,你可能想要在用户被授权更新权限的情况下才显示更新表单。在这种情况下,你可以使用 @can 和 @cannot 指令:
@can('update', $post)
@elsecan('create', $post)

@endcan
@cannot('update', $post)
@elsecannot('create', $post)
@endcannot这种写法可看作是

@if 和 @unless 语句的缩写,上面的 @can 和 @cannot 语句与下面的语句等价:
@if (Auth::user()->can('update', $post))
@endif@unless (Auth::user()->can('update', $post))
@endunless不依赖模型的动作和其它授权方法一样,

如果授权动作不需要传入模型实例的情况下可以传递类名给 @can 和 @cannot 指令:
@can('create', Post::class)
@endcan@cannot('create', Post::class)
@endcannot

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容