授权

介绍
门卫
创建策略
- 生成策略
- 注册策略
编写策略
使用策略授权操作

介绍

除了提供内置的认证服务外，Laravel 还提供了一种简单的方法来对用户操作进行授权，以便对给定资源进行操作。例如，即使用户已通过身份验证，他们可能没有被授权更新或删除由您的应用程序管理的某些 Eloquent 模型或数据库记录。Laravel 的授权功能提供了一种简单、有组织的方式来管理这些类型的授权检查。

Laravel 提供了两种主要的授权操作方式：门卫和策略。可以将门卫和策略视为路由和控制器。门卫提供了一种简单的、基于闭包的授权方法，而策略则像控制器一样，将逻辑围绕特定模型或资源进行分组。在本文档中，我们将首先探讨门卫，然后研究策略。

在构建应用程序时，您不需要在仅使用门卫或仅使用策略之间进行选择。大多数应用程序很可能会包含一些门卫和策略的混合使用，这完全没有问题！门卫最适用于与任何模型或资源无关的操作，例如查看管理员仪表板。相反，当您希望为特定模型或资源授权操作时，应使用策略。

门卫

编写门卫

门卫是学习 Laravel 授权功能基础的好方法；然而，在构建强大的 Laravel 应用程序时，您应该考虑使用策略来组织您的授权规则。

门卫只是确定用户是否被授权执行给定操作的闭包。通常，门卫是在 App\Providers\AuthServiceProvider 类的 boot 方法中使用 Gate facade 定义的。门卫总是接收用户实例作为其第一个参数，并且可以选择接收其他参数，例如相关的 Eloquent 模型。

在此示例中，我们将定义一个门卫，以确定用户是否可以更新给定的 App\Models\Post 模型。门卫将通过将用户的 id 与创建帖子的用户的 user_id 进行比较来实现这一点：

php

use App\Models\Post;
use App\Models\User;
use Illuminate\Support\Facades\Gate;

/**
 * 注册任何身份验证/授权服务。
 *
 * @return void
 */
public function boot()
{
    $this->registerPolicies();

    Gate::define('update-post', function (User $user, Post $post) {
        return $user->id === $post->user_id;
    });
}

像控制器一样，门卫也可以使用类回调数组定义：

php

use App\Policies\PostPolicy;
use Illuminate\Support\Facades\Gate;

/**
 * 注册任何身份验证/授权服务。
 *
 * @return void
 */
public function boot()
{
    $this->registerPolicies();

    Gate::define('update-post', [PostPolicy::class, 'update']);
}

通过门卫授权操作

要使用门卫授权操作，您应该使用 Gate facade 提供的 allows 或 denies 方法。请注意，您不需要将当前认证的用户传递给这些方法。Laravel 会自动处理将用户传递到门卫闭包中。通常在执行需要授权的操作之前，在应用程序的控制器中调用门卫授权方法：

php

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\Post;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Gate;

class PostController extends Controller
{
    /**
     * 更新给定的帖子。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \App\Models\Post  $post
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, Post $post)
    {
        if (! Gate::allows('update-post', $post)) {
            abort(403);
        }

        // 更新帖子...
    }
}

如果您想确定当前认证的用户以外的用户是否被授权执行操作，可以使用 Gate facade 的 forUser 方法：

php

if (Gate::forUser($user)->allows('update-post', $post)) {
    // 用户可以更新帖子...
}

if (Gate::forUser($user)->denies('update-post', $post)) {
    // 用户不能更新帖子...
}

您可以使用 any 或 none 方法一次授权多个操作：

php

if (Gate::any(['update-post', 'delete-post'], $post)) {
    // 用户可以更新或删除帖子...
}

if (Gate::none(['update-post', 'delete-post'], $post)) {
    // 用户不能更新或删除帖子...
}

授权或抛出异常

如果您想尝试授权操作并在用户不被允许执行给定操作时自动抛出 Illuminate\Auth\Access\AuthorizationException，可以使用 Gate facade 的 authorize 方法。AuthorizationException 实例会被 Laravel 的异常处理程序自动转换为 403 HTTP 响应：

php

Gate::authorize('update-post', $post);

// 操作已授权...

提供额外的上下文

门卫方法用于授权能力（allows、denies、check、any、none、authorize、can、cannot）和授权 Blade 指令（@can、@cannot、@canany）可以接收一个数组作为其第二个参数。这些数组元素作为参数传递给门卫闭包，并可用于在进行授权决策时提供额外的上下文：

php

use App\Models\Category;
use App\Models\User;
use Illuminate\Support\Facades\Gate;

Gate::define('create-post', function (User $user, Category $category, $pinned) {
    if (! $user->canPublishToGroup($category->group)) {
        return false;
    } elseif ($pinned && ! $user->canPinPosts()) {
        return false;
    }

    return true;
});

if (Gate::check('create-post', [$category, $pinned])) {
    // 用户可以创建帖子...
}

门卫响应

到目前为止，我们只检查了返回简单布尔值的门卫。然而，有时您可能希望返回更详细的响应，包括错误消息。为此，您可以从门卫返回一个 Illuminate\Auth\Access\Response：

php

use App\Models\User;
use Illuminate\Auth\Access\Response;
use Illuminate\Support\Facades\Gate;

Gate::define('edit-settings', function (User $user) {
    return $user->isAdmin
                ? Response::allow()
                : Response::deny('您必须是管理员。');
});

即使您从门卫返回授权响应，Gate::allows 方法仍将返回一个简单的布尔值；然而，您可以使用 Gate::inspect 方法获取门卫返回的完整授权响应：

php

$response = Gate::inspect('edit-settings');

if ($response->allowed()) {
    // 操作已授权...
} else {
    echo $response->message();
}

使用 Gate::authorize 方法时，如果操作未被授权，将抛出 AuthorizationException，授权响应提供的错误消息将传播到 HTTP 响应中：

php

Gate::authorize('edit-settings');

// 操作已授权...

自定义 HTTP 响应状态

当通过门卫拒绝操作时，将返回 403 HTTP 响应；然而，有时返回替代 HTTP 状态码可能很有用。您可以使用 Illuminate\Auth\Access\Response 类上的 denyWithStatus 静态构造函数自定义授权检查失败时返回的 HTTP 状态码：

php

use App\Models\User;
use Illuminate\Auth\Access\Response;
use Illuminate\Support\Facades\Gate;

Gate::define('edit-settings', function (User $user) {
    return $user->isAdmin
                ? Response::allow()
                : Response::denyWithStatus(404);
});

由于通过 404 响应隐藏资源是 Web 应用程序中非常常见的模式，因此提供了 denyAsNotFound 方法以方便使用：

php

use App\Models\User;
use Illuminate\Auth\Access\Response;
use Illuminate\Support\Facades\Gate;

Gate::define('edit-settings', function (User $user) {
    return $user->isAdmin
                ? Response::allow()
                : Response::denyAsNotFound();
});

拦截门卫检查

有时，您可能希望为特定用户授予所有能力。您可以使用 before 方法定义一个在所有其他授权检查之前运行的闭包：

php

use Illuminate\Support\Facades\Gate;

Gate::before(function ($user, $ability) {
    if ($user->isAdministrator()) {
        return true;
    }
});

如果 before 闭包返回非空结果，则该结果将被视为授权检查的结果。

您可以使用 after 方法定义一个在所有其他授权检查之后执行的闭包：

php

Gate::after(function ($user, $ability, $result, $arguments) {
    if ($user->isAdministrator()) {
        return true;
    }
});

与 before 方法类似，如果 after 闭包返回非空结果，则该结果将被视为授权检查的结果。

内联授权

有时，您可能希望确定当前认证的用户是否被授权执行给定操作，而无需编写与该操作对应的专用门卫。Laravel 允许您通过 Gate::allowIf 和 Gate::denyIf 方法执行这些类型的“内联”授权检查：

php

use Illuminate\Support\Facades\Gate;

Gate::allowIf(fn ($user) => $user->isAdministrator());

Gate::denyIf(fn ($user) => $user->banned());

如果操作未被授权或当前没有用户认证，Laravel 将自动抛出 Illuminate\Auth\Access\AuthorizationException 异常。AuthorizationException 实例会被 Laravel 的异常处理程序自动转换为 403 HTTP 响应。

创建策略

生成策略

策略是围绕特定模型或资源组织授权逻辑的类。例如，如果您的应用程序是一个博客，您可能有一个 App\Models\Post 模型和一个相应的 App\Policies\PostPolicy 来授权用户操作，例如创建或更新帖子。

您可以使用 make:policy Artisan 命令生成策略。生成的策略将放置在 app/Policies 目录中。如果您的应用程序中不存在此目录，Laravel 将为您创建它：

shell

php artisan make:policy PostPolicy

make:policy 命令将生成一个空的策略类。如果您希望生成一个包含与查看、创建、更新和删除资源相关的示例策略方法的类，可以在执行命令时提供 --model 选项：

shell

php artisan make:policy PostPolicy --model=Post

注册策略

策略类创建后，需要注册。注册策略是我们可以通知 Laravel 在对给定模型类型授权操作时使用哪个策略的方法。

包含在新 Laravel 应用程序中的 App\Providers\AuthServiceProvider 包含一个 policies 属性，该属性将您的 Eloquent 模型映射到其相应的策略。注册策略将指示 Laravel 在对给定 Eloquent 模型授权操作时使用哪个策略：

php

<?php

namespace App\Providers;

use App\Models\Post;
use App\Policies\PostPolicy;
use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
use Illuminate\Support\Facades\Gate;

class AuthServiceProvider extends ServiceProvider
{
    /**
     * 应用程序的策略映射。
     *
     * @var array
     */
    protected $policies = [
        Post::class => PostPolicy::class,
    ];

    /**
     * 注册任何应用程序身份验证/授权服务。
     *
     * @return void
     */
    public function boot()
    {
        $this->registerPolicies();

        //
    }
}

策略自动发现

Laravel 可以自动发现策略，只要模型和策略遵循标准的 Laravel 命名约定，而不是手动注册模型策略。具体来说，策略必须位于包含模型的目录或其上级目录中的 Policies 目录中。因此，例如，模型可以放置在 app/Models 目录中，而策略可以放置在 app/Policies 目录中。在这种情况下，Laravel 将在 app/Models/Policies 中检查策略，然后在 app/Policies 中检查。此外，策略名称必须与模型名称匹配，并具有 Policy 后缀。因此，User 模型将对应于 UserPolicy 策略类。

如果您希望定义自己的策略发现逻辑，可以使用 Gate::guessPolicyNamesUsing 方法注册自定义策略发现回调。通常，此方法应从应用程序的 AuthServiceProvider 的 boot 方法中调用：

php

use Illuminate\Support\Facades\Gate;

Gate::guessPolicyNamesUsing(function ($modelClass) {
    // 返回给定模型的策略类名称...
});

在您的 AuthServiceProvider 中显式映射的任何策略都将优先于任何可能自动发现的策略。

编写策略

策略方法

策略类注册后，您可以为其授权的每个操作添加方法。例如，让我们在我们的 PostPolicy 上定义一个 update 方法，该方法确定给定的 App\Models\User 是否可以更新给定的 App\Models\Post 实例。

update 方法将接收一个 User 和一个 Post 实例作为其参数，并应返回 true 或 false，指示用户是否被授权更新给定的 Post。因此，在此示例中，我们将验证用户的 id 是否与帖子的 user_id 匹配：

php

<?php

namespace App\Policies;

use App\Models\Post;
use App\Models\User;

class PostPolicy
{
    /**
     * 确定给定的帖子是否可以由用户更新。
     *
     * @param  \App\Models\User  $user
     * @param  \App\Models\Post  $post
     * @return bool
     */
    public function update(User $user, Post $post)
    {
        return $user->id === $post->user_id;
    }
}

您可以根据需要继续在策略上定义其他方法，以授权其授权的各种操作。例如，您可以定义 view 或 delete 方法来授权与 Post 相关的各种操作，但请记住，您可以自由地为策略方法命名。

如果您在通过 Artisan 控制台生成策略时使用了 --model 选项，它将已经包含与 viewAny、view、create、update、delete、restore 和 forceDelete 操作相关的方法。

所有策略都是通过 Laravel 服务容器解析的，允许您在策略的构造函数中类型提示任何所需的依赖项，以便它们自动注入。

策略响应

到目前为止，我们只检查了返回简单布尔值的策略方法。然而，有时您可能希望返回更详细的响应，包括错误消息。为此，您可以从策略方法返回一个 Illuminate\Auth\Access\Response 实例：

php

use App\Models\Post;
use App\Models\User;
use Illuminate\Auth\Access\Response;

/**
 * 确定给定的帖子是否可以由用户更新。
 *
 * @param  \App\Models\User  $user
 * @param  \App\Models\Post  $post
 * @return \Illuminate\Auth\Access\Response
 */
public function update(User $user, Post $post)
{
    return $user->id === $post->user_id
                ? Response::allow()
                : Response::deny('您不拥有此帖子。');
}

当从策略返回授权响应时，Gate::allows 方法仍将返回一个简单的布尔值；然而，您可以使用 Gate::inspect 方法获取门卫返回的完整授权响应：

php

use Illuminate\Support\Facades\Gate;

$response = Gate::inspect('update', $post);

if ($response->allowed()) {
    // 操作已授权...
} else {
    echo $response->message();
}

使用 Gate::authorize 方法时，如果操作未被授权，将抛出 AuthorizationException，授权响应提供的错误消息将传播到 HTTP 响应中：

php

Gate::authorize('update', $post);

// 操作已授权...

自定义 HTTP 响应状态

当通过策略方法拒绝操作时，将返回 403 HTTP 响应；然而，有时返回替代 HTTP 状态码可能很有用。您可以使用 Illuminate\Auth\Access\Response 类上的 denyWithStatus 静态构造函数自定义授权检查失败时返回的 HTTP 状态码：

php

use App\Models\Post;
use App\Models\User;
use Illuminate\Auth\Access\Response;

/**
 * 确定给定的帖子是否可以由用户更新。
 *
 * @param  \App\Models\User  $user
 * @param  \App\Models\Post  $post
 * @return \Illuminate\Auth\Access\Response
 */
public function update(User $user, Post $post)
{
    return $user->id === $post->user_id
                ? Response::allow()
                : Response::denyWithStatus(404);
}

由于通过 404 响应隐藏资源是 Web 应用程序中非常常见的模式，因此提供了 denyAsNotFound 方法以方便使用：

php

use App\Models\Post;
use App\Models\User;
use Illuminate\Auth\Access\Response;

/**
 * 确定给定的帖子是否可以由用户更新。
 *
 * @param  \App\Models\User  $user
 * @param  \App\Models\Post  $post
 * @return \Illuminate\Auth\Access\Response
 */
public function update(User $user, Post $post)
{
    return $user->id === $post->user_id
                ? Response::allow()
                : Response::denyAsNotFound();
}

无模型的方法

某些策略方法仅接收当前认证用户的实例。这种情况在授权 create 操作时最为常见。例如，如果您正在创建一个博客，您可能希望确定用户是否被授权创建任何帖子。在这些情况下，您的策略方法应仅期望接收一个用户实例：

php

/**
 * 确定给定用户是否可以创建帖子。
 *
 * @param  \App\Models\User  $user
 * @return bool
 */
public function create(User $user)
{
    return $user->role == 'writer';
}

访客用户

默认情况下，如果传入的 HTTP 请求不是由经过身份验证的用户发起的，则所有门卫和策略都会自动返回 false。然而，您可以通过声明“可选”类型提示或为用户参数定义提供 null 默认值来允许这些授权检查通过到您的门卫和策略：

php

<?php

namespace App\Policies;

use App\Models\Post;
use App\Models\User;

class PostPolicy
{
    /**
     * 确定给定的帖子是否可以由用户更新。
     *
     * @param  \App\Models\User  $user
     * @param  \App\Models\Post  $post
     * @return bool
     */
    public function update(?User $user, Post $post)
    {
        return optional($user)->id === $post->user_id;
    }
}

策略过滤器

对于某些用户，您可能希望授权给定策略中的所有操作。为此，请在策略上定义一个 before 方法。before 方法将在策略上的任何其他方法之前执行，给您一个机会在实际调用预期的策略方法之前授权操作。此功能最常用于授权应用程序管理员执行任何操作：

php

use App\Models\User;

/**
 * 执行预授权检查。
 *
 * @param  \App\Models\User  $user
 * @param  string  $ability
 * @return void|bool
 */
public function before(User $user, $ability)
{
    if ($user->isAdministrator()) {
        return true;
    }
}

如果您希望拒绝对特定类型用户的所有授权检查，则可以从 before 方法返回 false。如果返回 null，授权检查将传递到策略方法。

如果类不包含与被检查能力名称匹配的方法，则不会调用策略类的 before 方法。

使用策略授权操作

通过用户模型

Laravel 应用程序中包含的 App\Models\User 模型包括两个用于授权操作的有用方法：can 和 cannot。can 和 cannot 方法接收您希望授权的操作名称和相关模型。例如，让我们确定用户是否被授权更新给定的 App\Models\Post 模型。通常，这将在控制器方法中完成：

php

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    /**
     * 更新给定的帖子。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \App\Models\Post  $post
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, Post $post)
    {
        if ($request->user()->cannot('update', $post)) {
            abort(403);
        }

        // 更新帖子...
    }
}

如果为给定模型注册了策略，can 方法将自动调用相应的策略并返回布尔结果。如果没有为模型注册策略，can 方法将尝试调用与给定操作名称匹配的基于闭包的门卫。

不需要模型的操作

请记住，某些操作可能对应于不需要模型实例的策略方法，例如 create。在这些情况下，您可以将类名传递给 can 方法。类名将用于确定在授权操作时使用哪个策略：

php

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    /**
     * 创建帖子。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        if ($request->user()->cannot('create', Post::class)) {
            abort(403);
        }

        // 创建帖子...
    }
}

通过控制器助手

除了为 App\Models\User 模型提供的有用方法外，Laravel 还为扩展 App\Http\Controllers\Controller 基类的任何控制器提供了一个有用的 authorize 方法。

与 can 方法一样，此方法接受您希望授权的操作名称和相关模型。如果操作未被授权，authorize 方法将抛出一个 Illuminate\Auth\Access\AuthorizationException 异常，Laravel 的异常处理程序将自动将其转换为带有 403 状态码的 HTTP 响应：

php

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    /**
     * 更新给定的博客帖子。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \App\Models\Post  $post
     * @return \Illuminate\Http\Response
     *
     * @throws \Illuminate\Auth\Access\AuthorizationException
     */
    public function update(Request $request, Post $post)
    {
        $this->authorize('update', $post);

        // 当前用户可以更新博客帖子...
    }
}

不需要模型的操作

如前所述，某些策略方法（如 create）不需要模型实例。在这些情况下，您应该将类名传递给 authorize 方法。类名将用于确定在授权操作时使用哪个策略：

php

use App\Models\Post;
use Illuminate\Http\Request;

/**
 * 创建新的博客帖子。
 *
 * @param  \Illuminate\Http\Request  $request
 * @return \Illuminate\Http\Response
 *
 * @throws \Illuminate\Auth\Access\AuthorizationException
 */
public function create(Request $request)
{
    $this->authorize('create', Post::class);

    // 当前用户可以创建博客帖子...
}

授权资源控制器

如果您正在使用资源控制器，可以在控制器的构造函数中使用 authorizeResource 方法。此方法将适当的 can 中间件定义附加到资源控制器的方法。

authorizeResource 方法接受模型的类名作为其第一个参数，以及将包含模型 ID 的路由/请求参数的名称作为其第二个参数。您应该确保使用 --model 标志创建资源控制器，以便它具有所需的方法签名和类型提示：

php

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    /**
     * 创建控制器实例。
     *
     * @return void
     */
    public function __construct()
    {
        $this->authorizeResource(Post::class, 'post');
    }
}

以下控制器方法将映射到其相应的策略方法。当请求路由到给定的控制器方法时，将在执行控制器方法之前自动调用相应的策略方法：

控制器方法	策略方法
index	viewAny
show	view
create	create
store	create
edit	update
update	update
destroy	delete

您可以使用 --model 选项与 make:policy 命令一起快速为给定模型生成策略类：php artisan make:policy PostPolicy --model=Post。

通过中间件

Laravel 包含一个中间件，可以在传入请求到达您的路由或控制器之前授权操作。默认情况下，Illuminate\Auth\Middleware\Authorize 中间件在您的 App\Http\Kernel 类中分配了 can 键。让我们探索一个使用 can 中间件授权用户可以更新帖子的示例：

php

use App\Models\Post;

Route::put('/post/{post}', function (Post $post) {
    // 当前用户可以更新帖子...
})->middleware('can:update,post');

在此示例中，我们将 can 中间件传递了两个参数。第一个是我们希望授权的操作名称，第二个是我们希望传递给策略方法的路由参数。在这种情况下，由于我们使用了隐式模型绑定，将 App\Models\Post 模型传递给策略方法。如果用户无权执行给定操作，中间件将返回带有 403 状态码的 HTTP 响应。

为了方便起见，您还可以使用 can 方法将 can 中间件附加到您的路由：

php

use App\Models\Post;

Route::put('/post/{post}', function (Post $post) {
    // 当前用户可以更新帖子...
})->can('update', 'post');

不需要模型的操作

同样，某些策略方法（如 create）不需要模型实例。在这些情况下，您可以将类名传递给中间件。类名将用于确定在授权操作时使用哪个策略：

php

Route::post('/post', function () {
    // 当前用户可以创建帖子...
})->middleware('can:create,App\Models\Post');

在字符串中间件定义中指定整个类名可能会变得繁琐。因此，您可以选择使用 can 方法将 can 中间件附加到您的路由：

php

use App\Models\Post;

Route::post('/post', function () {
    // 当前用户可以创建帖子...
})->can('create', Post::class);

通过 Blade 模板

在编写 Blade 模板时，您可能希望仅在用户被授权执行给定操作时显示页面的一部分。例如，您可能希望仅在用户可以实际更新帖子时显示博客帖子的更新表单。在这种情况下，您可以使用 @can 和 @cannot 指令：

blade

@can('update', $post)
    <!-- 当前用户可以更新帖子... -->
@elsecan('create', App\Models\Post::class)
    <!-- 当前用户可以创建新帖子... -->
@else
    <!-- ... -->
@endcan

@cannot('update', $post)
    <!-- 当前用户不能更新帖子... -->
@elsecannot('create', App\Models\Post::class)
    <!-- 当前用户不能创建新帖子... -->
@endcannot

这些指令是编写 @if 和 @unless 语句的便捷快捷方式。上面的 @can 和 @cannot 语句等效于以下语句：

blade

@if (Auth::user()->can('update', $post))
    <!-- 当前用户可以更新帖子... -->
@endif

@unless (Auth::user()->can('update', $post))
    <!-- 当前用户不能更新帖子... -->
@endunless

您还可以确定用户是否被授权执行给定操作数组中的任何操作。为此，请使用 @canany 指令：

blade

@canany(['update', 'view', 'delete'], $post)
    <!-- 当前用户可以更新、查看或删除帖子... -->
@elsecanany(['create'], \App\Models\Post::class)
    <!-- 当前用户可以创建帖子... -->
@endcanany

不需要模型的操作

与大多数其他授权方法一样，如果操作不需要模型实例，您可以将类名传递给 @can 和 @cannot 指令：

blade

@can('create', App\Models\Post::class)
    <!-- 当前用户可以创建帖子... -->
@endcan

@cannot('create', App\Models\Post::class)
    <!-- 当前用户不能创建帖子... -->
@endcannot

提供额外的上下文

在使用策略授权操作时，您可以将数组作为第二个参数传递给各种授权函数和助手。数组中的第一个元素将用于确定应调用哪个策略，而数组的其余元素将作为参数传递给策略方法，并可用于在进行授权决策时提供额外的上下文。例如，考虑以下包含额外 $category 参数的 PostPolicy 方法定义：

php

/**
 * 确定给定的帖子是否可以由用户更新。
 *
 * @param  \App\Models\User  $user
 * @param  \App\Models\Post  $post
 * @param  int  $category
 * @return bool
 */
public function update(User $user, Post $post, int $category)
{
    return $user->id === $post->user_id &&
           $user->canUpdateCategory($category);
}

在尝试确定认证用户是否可以更新给定帖子时，我们可以像这样调用此策略方法：

php

/**
 * 更新给定的博客帖子。
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \App\Models\Post  $post
 * @return \Illuminate\Http\Response
 *
 * @throws \Illuminate\Auth\Access\AuthorizationException
 */
public function update(Request $request, Post $post)
{
    $this->authorize('update', [$post, $request->category]);

    // 当前用户可以更新博客帖子...
}

授权 ​

介绍 ​

门卫 ​

编写门卫 ​

通过门卫授权操作 ​

授权或抛出异常 ​

提供额外的上下文 ​

门卫响应 ​

自定义 HTTP 响应状态 ​

拦截门卫检查 ​

内联授权 ​

创建策略 ​

生成策略 ​

注册策略 ​

策略自动发现 ​

编写策略 ​

策略方法 ​

策略响应 ​

自定义 HTTP 响应状态 ​

无模型的方法 ​

访客用户 ​

策略过滤器 ​

使用策略授权操作 ​

通过用户模型 ​

不需要模型的操作 ​

通过控制器助手 ​

不需要模型的操作 ​

授权资源控制器 ​

通过中间件 ​

不需要模型的操作 ​

通过 Blade 模板 ​

不需要模型的操作 ​

提供额外的上下文 ​

授权

介绍

门卫

编写门卫

通过门卫授权操作

授权或抛出异常

提供额外的上下文

门卫响应

自定义 HTTP 响应状态

拦截门卫检查

内联授权

创建策略

生成策略

注册策略

策略自动发现

编写策略

策略方法

策略响应

自定义 HTTP 响应状态

无模型的方法

访客用户

策略过滤器

使用策略授权操作

通过用户模型

不需要模型的操作

通过控制器助手

不需要模型的操作

授权资源控制器

通过中间件

不需要模型的操作

通过 Blade 模板

不需要模型的操作

提供额外的上下文