0

0

如何在Laravel中配置路由中间件

畫卷琴夢

畫卷琴夢

发布时间:2025-07-16 18:17:02

|

662人浏览过

|

来源于php中文网

原创

如何在 laravel 中配置路由中间件?解决方案主要有三种方式:全局中间件、路由组中间件和单个路由中间件。1. 全局中间件会应用于每一个 http 请求,通过在 app/http/kernel.php 的 $middleware 数组中注册;2. 路由组中间件用于将中间件应用到一组路由,通过在 $middlewaregroups 数组中定义并在路由文件中使用 middleware 方法分配;3. 单个路由中间件允许将中间件应用到具体路由,通过在路由定义时调用 middleware 方法并指定中间件别名。自定义中间件需先使用 artisan 命令创建,并在 handle 方法中编写逻辑,然后在 $routemiddleware 数组中注册别名,以便在路由中引用。此外,中间件支持参数传递,可在路由定义中通过冒号分隔传递参数至 handle 方法。

如何在Laravel中配置路由中间件

路由中间件,简单说,就是在请求到达你的控制器之前,或者离开你的控制器之后,执行的一段代码。它就像一个守门员,可以检查用户是否登录,验证权限,或者记录请求日志。配置路由中间件,其实就是在告诉 Laravel,哪些路由需要经过哪些“守门员”的检查。

解决方案

在 Laravel 中配置路由中间件主要有三种方式:全局中间件、路由组中间件和单个路由中间件。

  1. 全局中间件: 这类中间件会应用到每一个 HTTP 请求。你可以在 app/Http/Kernel.php 文件的 $middleware 数组中注册全局中间件。例如,Laravel 默认包含的 \App\Http\Middleware\TrustProxies::class\App\Http\Middleware\PreventRequestsDuringMaintenance::class 都是全局中间件。 添加自定义全局中间件,只需要将你的中间件类添加到 $middleware 数组即可。

  2. 路由组中间件: 这种方式允许你将中间件应用到一组路由。在 app/Http/Kernel.php 文件的 $middlewareGroups 数组中定义路由组中间件。例如,webapi 组是 Laravel 默认提供的。 你可以创建自己的路由组,并在 routes/web.phproutes/api.php 中使用 middleware 方法将路由分配到该组。

  3. 单个路由中间件: 这是最灵活的方式,允许你将中间件应用到单个路由。 你可以在路由定义中使用 middleware 方法指定中间件。例如:Route::get('/profile', [UserController::class, 'show'])->middleware('auth');。 这里的 auth 是一个已经注册的中间件别名。 中间件别名在 app/Http/Kernel.php 文件的 $routeMiddleware 数组中定义。

中间件的创建:

使用 Artisan 命令 php artisan make:middleware YourMiddlewareName 可以快速创建一个新的中间件。 这个命令会在 app/Http/Middleware 目录下生成一个中间件类。 你需要在 handle 方法中编写中间件的逻辑。

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class YourMiddlewareName
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure(\Illuminate\Http\Request): (\Illuminate\Http\Response|\Illuminate\Http\RedirectResponse)  $next
     * @return \Illuminate\Http\Response|\Illuminate\Http\RedirectResponse
     */
    public function handle(Request $request, Closure $next)
    {
        // 在请求到达控制器之前执行的代码

        $response = $next($request);

        // 在请求离开控制器之后执行的代码

        return $response;
    }
}

$next($request) 这行代码会将请求传递给下一个中间件或控制器。 你可以在这行代码之前和之后添加你的自定义逻辑。

如何在Laravel中注册自定义路由中间件?

注册自定义路由中间件,需要在app/Http/Kernel.php文件的$routeMiddleware数组中添加你的中间件。这个数组是一个键值对,键是中间件的别名,值是中间件类的完全限定名称。例如:

听脑AI
听脑AI

听脑AI语音,一款专注于音视频内容的工作学习助手,为用户提供便捷的音视频内容记录、整理与分析功能。

下载
protected $routeMiddleware = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'yourmiddleware' => \App\Http\Middleware\YourMiddlewareName::class, // 添加你的自定义中间件
];

注册完成后,你就可以在路由定义中使用 yourmiddleware 这个别名来应用你的自定义中间件了。

路由中间件和控制器中间件有什么区别?

区别在于应用的位置和方式。路由中间件是在路由定义时直接应用,通过 Route::middleware() 或在 routes/web.phproutes/api.php 文件中指定。控制器中间件则是在控制器内部应用,通常在控制器的构造函数中使用 $this->middleware() 方法。

路由中间件更灵活,可以应用于单个路由、路由组或全局。控制器中间件更方便,可以直接在控制器内部管理中间件。选择哪种方式取决于你的具体需求。如果中间件只应用于特定的控制器,那么控制器中间件可能更合适。如果中间件需要应用于多个控制器或路由,那么路由中间件可能更灵活。

中间件中的参数传递

有些时候,你可能需要在中间件中传递参数。 Laravel 允许你这样做。 例如,你可以定义一个中间件来检查用户是否具有特定的权限。

首先,在你的中间件中接收参数:

public function handle(Request $request, Closure $next, $permission)
{
    if (! $request->user()->hasPermission($permission)) {
        abort(403, 'Unauthorized.');
    }

    return $next($request);
}

然后,在路由定义中传递参数:

Route::get('/admin', [AdminController::class, 'index'])->middleware('permission:edit-articles');

在这个例子中,edit-articles 参数会被传递到 handle 方法的 $permission 参数中。 注意,当传递多个参数时,参数之间用冒号分隔。

这几种配置方式,可以根据实际需求灵活运用,让你的 Laravel 应用更加安全和可控。

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

340

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

294

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

774

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

386

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

144

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

85

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

80

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

611

2026.03.04

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.7万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号