授权

简介
Gate（授权网关）
创建策略
- 生成策略
- 注册策略
编写策略
使用策略授权操作
授权与 Inertia

简介

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

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

在构建应用程序时，您无需在专门使用 Gate 或专门使用策略之间做出选择。大多数应用程序很可能同时包含 Gate 和策略，这完全没问题！Gate 最适用于与任何模型或资源无关的操作，例如查看管理员仪表板。相比之下，当您希望针对特定模型或资源授权操作时，应使用策略。

Gate（授权网关）

编写 Gate

WARNING

Gate 是学习 Laravel 授权功能基础的好方法；但是，在构建健壮的 Laravel 应用程序时，您应该考虑使用策略来组织您的授权规则。

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

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

php

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

/**
 * 引导任何应用程序服务。
 */
public function boot(): void
{
    Gate::define('update-post', function (User $user, Post $post) {
        return $user->id === $post->user_id;
    });
}

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

php

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

/**
 * 引导任何应用程序服务。
 */
public function boot(): void
{
    Gate::define('update-post', [PostPolicy::class, 'update']);
}

授权操作

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

php

<?php

namespace App\Http\Controllers;

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

class PostController extends Controller
{
    /**
     * 更新给定的帖子。
     */
    public function update(Request $request, Post $post): RedirectResponse
    {
        if (! Gate::allows('update-post', $post)) {
            abort(403);
        }

        // 更新帖子...

        return redirect('/posts');
    }
}

如果您想确定当前已认证用户以外的用户是否有权执行操作，您可以在 Gate 门面上使用 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 门面的 authorize 方法。AuthorizationException 实例会被 Laravel 自动转换为 403 HTTP 响应：

php

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

// 该操作已被授权...

提供额外上下文

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

php

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

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

    return true;
});

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

Gate 响应

到目前为止，我们只研究了返回简单布尔值的 Gate。但是，有时您可能希望返回更详细的响应，包括错误消息。为此，您可以从 Gate 返回一个 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 返回了授权响应，Gate::allows 方法仍将返回一个简单的布尔值；但是，您可以使用 Gate::inspect 方法获取 Gate 返回的完整授权响应：

php

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

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

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

php

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

// 该操作已被授权...

自定义 HTTP 响应状态

当操作通过 Gate 被拒绝时，将返回一个 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();
});

拦截 Gate 检查

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

php

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

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

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

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

php

use App\Models\User;

Gate::after(function (User $user, string $ability, bool|null $result, mixed $arguments) {
    if ($user->isAdministrator()) {
        return true;
    }
});

after 闭包返回的值不会覆盖授权检查的结果，除非 Gate 或策略返回了 null。

内联授权

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

php

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

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

Gate::denyIf(fn (User $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 就会自动发现策略。具体来说，策略必须位于包含模型的目录或其上级目录中的 Policies 目录中。因此，例如，模型可以放置在 app/Models 目录中，而策略可以放置在 app/Policies 目录中。在这种情况下，Laravel 将首先检查 app/Models/Policies，然后检查 app/Policies。此外，策略名称必须与模型名称匹配，并具有 Policy 后缀。因此，User 模型将对应 UserPolicy 策略类。

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

php

use Illuminate\Support\Facades\Gate;

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

手动注册策略

使用 Gate 门面，您可以在应用程序的 AppServiceProvider 的 boot 方法中手动注册策略及其对应的模型：

php

use App\Models\Order;
use App\Policies\OrderPolicy;
use Illuminate\Support\Facades\Gate;

/**
 * 引导任何应用程序服务。
 */
public function boot(): void
{
    Gate::policy(Order::class, OrderPolicy::class);
}

或者，您可以在模型类上放置 UsePolicy 属性，以告知 Laravel 该模型对应的策略：

php

<?php

namespace App\Models;

use App\Policies\OrderPolicy;
use Illuminate\Database\Eloquent\Attributes\UsePolicy;
use Illuminate\Database\Eloquent\Model;

#[UsePolicy(OrderPolicy::class)]
class Order extends Model
{
    //
}

编写策略

策略方法

注册策略类后，您可以为其授权的每个操作添加方法。例如，让我们在 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
{
    /**
     * 确定给定的帖子是否可以被用户更新。
     */
    public function update(User $user, Post $post): bool
    {
        return $user->id === $post->user_id;
    }
}

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

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

NOTE

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

策略响应

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

php

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

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

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

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;

/**
 * 确定给定的帖子是否可以被用户更新。
 */
public function update(User $user, Post $post): Response
{
    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;

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

无需模型的方法

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

php

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

访客用户

默认情况下，如果传入的 HTTP 请求不是由已验证用户发起的，所有 Gate 和策略都会自动返回 false。但是，您可以通过为用户参数声明一个“可选”类型提示或提供一个 null 默认值，允许这些授权检查传递到您的 Gate 和策略：

php

<?php

namespace App\Policies;

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

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

策略过滤器

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

php

use App\Models\User;

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

    return null;
}

如果您想拒绝特定类型用户的所有授权检查，那么您可以从 before 方法返回 false。如果返回 null，授权检查将回退到策略方法。

WARNING

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

使用策略授权操作

通过用户模型

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

php

<?php

namespace App\Http\Controllers;

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

class PostController extends Controller
{
    /**
     * 更新给定的帖子。
     */
    public function update(Request $request, Post $post): RedirectResponse
    {
        if ($request->user()->cannot('update', $post)) {
            abort(403);
        }

        // 更新帖子...

        return redirect('/posts');
    }
}

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

无需模型的操作

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

php

<?php

namespace App\Http\Controllers;

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

class PostController extends Controller
{
    /**
     * 创建一篇帖子。
     */
    public function store(Request $request): RedirectResponse
    {
        if ($request->user()->cannot('create', Post::class)) {
            abort(403);
        }

        // 创建帖子...

        return redirect('/posts');
    }
}

通过 `Gate` 门面

除了提供给 App\Models\User 模型的有用方法之外，您始终可以通过 Gate 门面的 authorize 方法来授权操作。

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

php

<?php

namespace App\Http\Controllers;

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

class PostController extends Controller
{
    /**
     * 更新给定的博客帖子。
     *
     * @throws \Illuminate\Auth\Access\AuthorizationException
     */
    public function update(Request $request, Post $post): RedirectResponse
    {
        Gate::authorize('update', $post);

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

        return redirect('/posts');
    }
}

无需模型的操作

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

php

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

/**
 * 创建一篇新的博客帖子。
 *
 * @throws \Illuminate\Auth\Access\AuthorizationException
 */
public function create(Request $request): RedirectResponse
{
    Gate::authorize('create', Post::class);

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

    return redirect('/posts');
}

通过中间件

Laravel 包含一个中间件，可以在传入请求到达您的路由或控制器之前授权操作。默认情况下，Illuminate\Auth\Middleware\Authorize 中间件可以使用 can 中间件别名附加到路由，该别名由 Laravel 自动注册。让我们探讨一个使用 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');

如果您正在使用控制器中间件属性，您可以通过 Authorize 属性应用 can 中间件：

php

use Illuminate\Routing\Attributes\Controllers\Authorize;

#[Authorize('update', 'post')]
public function update(Post $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

提供额外上下文

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

php

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

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

php

/**
 * 更新给定的博客帖子。
 *
 * @throws \Illuminate\Auth\Access\AuthorizationException
 */
public function update(Request $request, Post $post): RedirectResponse
{
    Gate::authorize('update', [$post, $request->category]);

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

    return redirect('/posts');
}

授权与 Inertia

虽然授权必须始终在服务器端处理，但为前端应用程序提供授权数据以正确渲染应用程序的 UI 通常会很方便。Laravel 没有为向 Inertia 驱动的前端公开授权信息定义必需的约定。

但是，如果您正在使用 Laravel 的基于 Inertia 的启动工具包之一，您的应用程序已经包含一个 HandleInertiaRequests 中间件。在此中间件的 share 方法中，您可以返回将提供给应用程序中所有 Inertia 页面的共享数据。这些共享数据可以作为定义用户授权信息的便捷位置：

php

<?php

namespace App\Http\Middleware;

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

class HandleInertiaRequests extends Middleware
{
    // ...

    /**
     * 定义默认共享的属性。
     *
     * @return array<string, mixed>
     */
    public function share(Request $request)
    {
        return [
            ...parent::share($request),
            'auth' => [
                'user' => $request->user(),
                'permissions' => [
                    'post' => [
                        'create' => $request->user()->can('create', Post::class),
                    ],
                ],
            ],
        ];
    }
}

授权 ​

简介 ​

Gate（授权网关） ​

编写 Gate ​

授权操作 ​

授权或抛出异常 ​

提供额外上下文 ​

Gate 响应 ​

自定义 HTTP 响应状态 ​

拦截 Gate 检查 ​

内联授权 ​

创建策略 ​

生成策略 ​

注册策略 ​

策略发现 ​

手动注册策略 ​

编写策略 ​

策略方法 ​

策略响应 ​

自定义 HTTP 响应状态 ​

无需模型的方法 ​

访客用户 ​

策略过滤器 ​

使用策略授权操作 ​

通过用户模型 ​

无需模型的操作 ​

通过 Gate 门面 ​

无需模型的操作 ​

通过中间件 ​

无需模型的操作 ​

通过 Blade 模板 ​

无需模型的操作 ​

提供额外上下文 ​

授权与 Inertia ​

授权

简介

Gate（授权网关）

编写 Gate

授权操作

授权或抛出异常

提供额外上下文

Gate 响应

自定义 HTTP 响应状态

拦截 Gate 检查

内联授权

创建策略

生成策略

注册策略

策略发现

手动注册策略

编写策略

策略方法

策略响应

自定义 HTTP 响应状态

无需模型的方法

访客用户

策略过滤器

使用策略授权操作

通过用户模型

无需模型的操作

通过 `Gate` 门面

无需模型的操作

通过中间件

无需模型的操作

通过 Blade 模板

无需模型的操作

提供额外上下文

授权与 Inertia