首页 > php框架 > Laravel > 正文

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

穿越時空
发布: 2025-09-17 11:20:01
原创
807人浏览过
创建中间件需通过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
    登录后复制
    方法。在这个方法里编写你的逻辑。例如,检查用户年龄:

    <?php
    
    namespace App\Http\Middleware;
    
    use Closure;
    use Illuminate\Http\Request;
    
    class CheckAge
    {
        /**
         * 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)
        {
            if ($request->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
      登录后复制
      数组中,并指定一个别名。

      Alkaid.art
      Alkaid.art

      专门为Phtoshop打造的AIGC绘画插件

      Alkaid.art 153
      查看详情 Alkaid.art
      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
登录后复制
文件中定义全局的异常处理逻辑。

以上就是Laravel如何创建自定义中间件_自定义请求处理逻辑的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

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