Spatie Laravel Permission 中间件使用指南

房凡鸣

于 2025-06-03 09:05:22 发布

阅读量436

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00493/article/details/148393023

Spatie Laravel Permission 中间件使用指南

laravel-permission Associate users with roles and permissions 项目地址: https://gitcode.com/gh_mirrors/la/laravel-permission

前言

在 Laravel 应用开发中，权限管理是保障系统安全的重要环节。Spatie Laravel Permission 作为 Laravel 生态中广受欢迎的权限管理包，提供了完善的中间件支持，帮助开发者轻松实现路由和控制器级别的权限控制。本文将详细介绍如何利用该包的中间件功能来构建安全的应用程序。

中间件类型概述

Spatie Laravel Permission 提供了三种中间件：

角色中间件 (RoleMiddleware) - 验证用户是否具有指定角色
权限中间件 (PermissionMiddleware) - 验证用户是否具有指定权限
角色或权限中间件 (RoleOrPermissionMiddleware) - 验证用户是否具有指定角色或权限

中间件注册配置

Laravel 11+ 配置方式

在 Laravel 11 中，中间件别名注册位置发生了变化，需要在 /bootstrap/app.php 文件中配置：

->withMiddleware(function (Middleware $middleware) {
    $middleware->alias([
        'role' => \Spatie\Permission\Middleware\RoleMiddleware::class,
        'permission' => \Spatie\Permission\Middleware\PermissionMiddleware::class,
        'role_or_permission' => \Spatie\Permission\Middleware\RoleOrPermissionMiddleware::class,
    ]);
})

Laravel 9-10 配置方式

对于 Laravel 9 和 10 版本，需要在 app/Http/Kernel.php 文件中注册：

protected $middlewareAliases = [
    // 其他中间件...
    'role' => \Spatie\Permission\Middleware\RoleMiddleware::class,
    'permission' => \Spatie\Permission\Middleware\PermissionMiddleware::class,
    'role_or_permission' => \Spatie\Permission\Middleware\RoleOrPermissionMiddleware::class,
];

中间件优先级问题

在实际应用中，可能会遇到预期返回 403 未授权响应却返回了 404 未找到响应的情况。这通常是由于中间件优先级冲突导致的。解决方案是确保权限中间件在 Laravel 的 SubstituteBindings 中间件之前执行。

在 Laravel 11 中，可以使用 $middleware->prependToGroup() 方法来调整中间件执行顺序。

路由中使用中间件

注册中间件别名后，可以在路由定义中轻松使用：

基本用法

// 角色验证
Route::group(['middleware' => ['role:manager']], function () { ... });

// 权限验证
Route::group(['middleware' => ['permission:publish articles']], function () { ... });

// 角色或权限验证
Route::group(['middleware' => ['role_or_permission:publish articles']], function () { ... });

指定守卫

对于多认证系统，可以指定守卫：

Route::group(['middleware' => ['role:manager,api']], function () { ... });

多条件验证

使用 | 符号表示 OR 逻辑：

// 多个角色
Route::group(['middleware' => ['role:manager|writer']], function () { ... });

// 多个权限
Route::group(['middleware' => ['permission:publish articles|edit articles']], function () { ... });

// 混合验证
Route::group(['middleware' => ['role_or_permission:manager|edit articles']], function () { ... });

控制器中使用中间件

Laravel 11+ 控制器中间件

在 Laravel 11 中，如果控制器实现了 HasMiddleware 接口，可以使用 middleware() 方法：

public static function middleware(): array
{
    return [
        'role_or_permission:manager|edit articles',
        new Middleware('role:author', only: ['index']),
        new Middleware(\Spatie\Permission\Middleware\RoleMiddleware::using('manager'), except:['show']),
    ];
}

Laravel 10 及以下版本

在构造函数中注册中间件：

public function __construct()
{
    $this->middleware(['role:manager','permission:publish articles|edit articles']);
    $this->middleware(['role_or_permission:manager|edit articles,api']);
}

静态方法调用方式

所有中间件都支持通过静态 using 方法调用，参数可以是数组或 | 分隔的字符串：

Route::group([
    'middleware' => [
        \Spatie\Permission\Middleware\RoleMiddleware::using('manager'),
        \Spatie\Permission\Middleware\PermissionMiddleware::using(['publish articles', 'edit articles'])
    ]
], function () { ... });