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

41次阅读

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

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

解决方案：

生成中间件:

使用 Artisan 命令生成中间件类：
```
php artisan make:middleware CheckAge
```
这会在
```
app/Http/Middleware
```
目录下创建一个名为
```
CheckAge.php
```
的文件。

编写中间件逻辑:

打开

CheckAge.php

文件，你会看到一个

handle

方法。在这个方法里编写你的逻辑。例如，检查用户年龄：

<?php  namespace AppHttpMiddleware;  use Closure; use IlluminateHttpRequest;  class CheckAge {     /**      * Handle an incoming request.      *      * @param  IlluminateHttpRequest  $request      * @param  Closure(IlluminateHttpRequest): (IlluminateHttpResponse|IlluminateHttpRedirectResponse)  $next      * @return IlluminateHttpResponse|IlluminateHttpRedirectResponse      */     public function handle(Request $request, Closure $next)     {         if ($request->age < 18) {             return redirect('home'); // 年龄小于18岁，重定向到首页         }          return $next($request); // 年龄符合要求，继续处理请求     } }

$request

对象包含传入的 HTTP 请求数据，

$next

是一个闭包，用于将请求传递到下一个中间件或路由。

注册中间件:

你需要在

app/Http/Kernel.php

文件中注册你的中间件。有两种注册方式：

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

$middleware

数组中。

protected $middleware = [     AppHttpMiddlewareTrustProxies::class,     AppHttpMiddlewarePreventRequestsDuringMaintenance::class,     IlluminateFoundationHttpMiddlewareValidatePostSize::class,     AppHttpMiddlewareTrimStrings::class,     IlluminateFoundationHttpMiddlewareConvertEmptyStringsToNull::class,     AppHttpMiddlewareCheckAge::class, // 注册全局中间件 ];

路由中间件: 只对特定的路由生效。添加到

$routeMiddleware

数组中，并指定一个别名。

Descript

一个多功能的音频和视频编辑引擎

22

查看详情

protected $routeMiddleware = [     'auth' => AppHttpMiddlewareAuthenticate::class,     'auth.basic' => IlluminateAuthMiddlewareAuthenticateWithBasicAuth::class,     'cache.headers' => IlluminateHttpMiddlewareSetCacheHeaders::class,     'can' => IlluminateAuthMiddlewareAuthorize::class,     'guest' => AppHttpMiddlewareRedirectIfAuthenticated::class,     'throttle' => IlluminateRoutingMiddlewareThrottleRequests::class,     'age' => AppHttpMiddlewareCheckAge::class, // 注册路由中间件，别名为 'age' ];

使用中间件:
- 全局中间件: 注册后自动生效，无需额外操作。
- 路由中间件: 在路由定义中使用
```
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 的异常处理机制，在