0

0

如何在Laravel中创建自定义中间件

月夜之吻

月夜之吻

发布时间:2025-06-30 18:32:01

|

911人浏览过

|

来源于php中文网

原创

laravel 中间件是在请求到达应用前或响应离开后执行的代码,用于处理权限验证、日志记录等任务。1.生成中间件:使用 artisan 命令 php artisan make:middleware yourmiddlewarename 创建新中间件类。2.编辑中间件:在 handle 方法中编写逻辑,如检查请求参数或修改请求对象。3.注册中间件:可在 kernel.php 的 $middleware 数组中注册为全局中间件,或在 $routemiddleware 数组中注册并分配别名以供路由使用。4.在路由或控制器中使用中间件:通过 ->middleware('yourmiddleware') 应用。5.访问 session:可通过 $request->session() 获取 session 数据并进行判断或重定向。6.修改请求或响应:可调用 $request->merge() 添加参数,或通过 $response->headers->set() 添加头部信息。7.中间件执行顺序:全局中间件按 kernel.php 中定义顺序执行,路由中间件按路由定义顺序执行,而响应阶段则以相反顺序执行。

如何在Laravel中创建自定义中间件

中间件,简单来说,就是请求到达你的应用之前或者响应离开你的应用之后,可以执行的一段代码。在 Laravel 中,自定义中间件能让你灵活地处理各种 HTTP 请求,比如权限验证、日志记录,甚至修改请求或响应本身。

解决方案:

  1. 生成中间件: 使用 Artisan 命令 php artisan make:middleware YourMiddlewareName。这会在 app/Http/Middleware 目录下创建一个新的中间件类。

  2. 编辑中间件: 打开新生成的中间件文件,你会看到一个 handle 方法。在这里编写你的逻辑。例如,一个简单的示例:

    input('secret') !== 'correct_secret') {
                return response('Unauthorized.', 401);
            }
    
            return $next($request);
        }
    }

    这个例子检查请求中是否包含一个名为 secret 的参数,并且其值是否为 correct_secret。如果不匹配,则返回 401 未授权响应。$next($request) 表示将请求传递给下一个中间件或路由。

  3. 注册中间件: 你需要在 app/Http/Kernel.php 文件中注册你的中间件。有两种方式:

    • 全局中间件: 添加到 $middleware 数组中。全局中间件会应用于每个请求。
    • 路由中间件: 添加到 $routeMiddleware 数组中,并分配一个别名。然后你可以在路由中使用这个别名。
    // app/Http/Kernel.php
    
    protected $routeMiddleware = [
        'auth' => \App\Http\Middleware\Authenticate::class,
        'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
        'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::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, // 注册你的中间件
    ];
  4. 在路由中使用中间件: 如果你注册了路由中间件,你就可以在你的路由中使用它了。

    MakeSong
    MakeSong

    AI音乐生成,生成高质量音乐,仅需30秒的时间

    下载
    Route::get('/profile', function () {
        // 只有通过中间件验证的用户才能访问
    })->middleware('yourmiddleware');

    或者,你也可以在控制器中使用:

    public function __construct()
    {
        $this->middleware('yourmiddleware');
    }

如何在中间件中访问 Session?

Laravel 的 Session 管理非常方便。在你的中间件中,你可以像在控制器中一样访问 Session。例如:

public function handle(Request $request, Closure $next)
{
    $userId = $request->session()->get('user_id');

    if (!$userId) {
        return redirect('/login');
    }

    return $next($request);
}

这个例子检查 Session 中是否存在 user_id。如果不存在,则重定向到登录页面。 记得确保你的应用配置了 Session 中间件,通常 Laravel 默认已经配置好了。

如何修改请求或响应?

中间件的强大之处在于它可以修改请求和响应。例如,你可以在请求到达控制器之前修改请求参数,或者在响应返回给客户端之前添加额外的头部信息。

  • 修改请求: 你可以直接修改 $request 对象。

    public function handle(Request $request, Closure $next)
    {
        $request->merge(['new_param' => 'some_value']); // 添加新的请求参数
    
        return $next($request);
    }
  • 修改响应:$next($request) 之后,你可以访问并修改响应。

    public function handle(Request $request, Closure $next)
    {
        $response = $next($request);
    
        $response->headers->set('X-Custom-Header', 'Custom Value'); // 添加自定义头部
    
        return $response;
    }

中间件的执行顺序是怎样的?

中间件的执行顺序非常重要。全局中间件按照 app/Http/Kernel.php$middleware 数组的顺序执行。路由中间件按照它们在路由定义中的顺序执行。需要注意的是,中间件在请求到达之前执行的顺序,与响应离开时执行的顺序是相反的。这允许你在请求到达之前进行一些准备工作,然后在响应离开时进行清理或日志记录。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

319

2024.04.09

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

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

278

2024.04.09

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

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

372

2024.04.09

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

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

374

2024.04.10

laravel入门教程
laravel入门教程

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

85

2025.08.05

laravel实战教程
laravel实战教程

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

65

2025.08.05

laravel面试题
laravel面试题

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

68

2025.08.05

什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

178

2024.05.11

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
【web前端】Node.js快速入门
【web前端】Node.js快速入门

共16课时 | 2万人学习

550W粉丝大佬手把手从零学JavaScript
550W粉丝大佬手把手从零学JavaScript

共1课时 | 0.3万人学习

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

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