0

0

Laravel如何创建自定义中间件_自定义请求处理逻辑

穿越時空

穿越時空

发布时间:2025-09-17 11:20:01

|

842人浏览过

|

来源于php中文网

原创

创建中间件需通过Artisan命令生成,如php artisan make:middleware CheckAge,随后在handle方法中编写逻辑,例如检查年龄并重定向,接着在Kernel.php中注册为全局或路由中间件,最后在路由或控制器中使用;中间件执行顺序按注册和调用顺序进行,前置中间件先入后出,后置则相反;可在handle中修改$request数据或通过$response修改响应内容,并用try-catch处理异常,结合Laravel全局异常处理机制统一管理错误。

laravel如何创建自定义中间件_自定义请求处理逻辑

创建自定义中间件是为了在请求到达你的 Laravel 应用之前或之后,对请求进行预处理或后处理。简单来说,它就像一个请求的“守门人”,可以检查权限、修改请求数据、记录日志等等。

解决方案:

  1. 生成中间件:

    使用 Artisan 命令生成中间件类:

    php artisan make:middleware CheckAge

    这会在

    app/Http/Middleware
    目录下创建一个名为
    CheckAge.php
    的文件。

  2. 编写中间件逻辑:

    打开

    CheckAge.php
    文件,你会看到一个
    handle
    方法。在这个方法里编写你的逻辑。例如,检查用户年龄:

    age < 18) {
                return redirect('home'); // 年龄小于18岁,重定向到首页
            }
    
            return $next($request); // 年龄符合要求,继续处理请求
        }
    }

    $request
    对象包含传入的 HTTP 请求数据,
    $next
    是一个闭包,用于将请求传递到下一个中间件或路由

  3. 注册中间件:

    你需要在

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

    • 全局中间件: 所有请求都会经过这些中间件。添加到

      $middleware
      数组中。

      protected $middleware = [
          \App\Http\Middleware\TrustProxies::class,
          \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
          \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
          \App\Http\Middleware\TrimStrings::class,
          \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
          \App\Http\Middleware\CheckAge::class, // 注册全局中间件
      ];
    • 路由中间件: 只对特定的路由生效。添加到

      $routeMiddleware
      数组中,并指定一个别名。

      RecoveryFox AI
      RecoveryFox 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,
          'age' => \App\Http\Middleware\CheckAge::class, // 注册路由中间件,别名为 'age'
      ];
  4. 使用中间件:

    • 全局中间件: 注册后自动生效,无需额外操作。

    • 路由中间件: 在路由定义中使用

      middleware
      方法指定中间件别名。

      Route::get('/profile', function () {
          // 只有通过 CheckAge 中间件才能访问
      })->middleware('age');

      也可以在控制器中使用构造函数来应用中间件:

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

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

Laravel 中间件的执行顺序取决于它们在

app/Http/Kernel.php
文件中的注册方式。全局中间件按照
$middleware
数组中定义的顺序执行。路由中间件则按照它们在路由定义中指定的顺序执行。如果一个路由同时使用了多个路由中间件,它们会按照定义的顺序依次执行。需要注意的是,在请求到达路由之前执行的中间件,称为“前置中间件”;在路由处理完成后执行的中间件,称为“后置中间件”。后置中间件的执行顺序与前置中间件相反。

如何修改请求或响应数据?

在中间件的

handle
方法中,你可以直接修改
$request
对象来修改请求数据。例如,你可以添加、删除或修改请求参数。对于响应数据,你可以通过
$next($request)
获取到响应对象,然后对响应对象进行修改。例如,你可以修改响应头、状态码或内容。

public function handle(Request $request, Closure $next)
{
    // 修改请求数据
    $request->merge(['new_parameter' => 'new_value']);

    // 获取响应对象
    $response = $next($request);

    // 修改响应头
    $response->header('X-Custom-Header', 'Custom Value');

    return $response;
}

中间件中如何处理异常?

在中间件中捕获异常并进行处理是常见的做法。你可以使用

try-catch
块来捕获异常,并根据需要进行处理。例如,你可以记录日志、返回错误响应或重定向到错误页面。

public function handle(Request $request, Closure $next)
{
    try {
        return $next($request);
    } catch (\Exception $e) {
        // 记录日志
        \Log::error($e);

        // 返回错误响应
        return response()->json(['error' => 'An error occurred'], 500);
    }
}

此外,你还可以使用 Laravel 的异常处理机制,在

app/Exceptions/Handler.php
文件中定义全局的异常处理逻辑。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

320

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

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

158

2026.01.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
【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号