首页 > PHP > Laravel 中间件的解释及示例代码

Laravel 中间件的解释及示例代码

2025-01-10 09:51:19
一、Laravel 中间件解释

中间件在 Laravel 中是一个非常重要的概念,它为处理 HTTP 请求提供了一种方便的机制,允许你在请求到达应用程序的路由或控制器之前或之后执行一些逻辑操作。可以将其看作是请求处理流程中的一系列过滤器,用于执行诸如身份验证、日志记录、修改请求或响应、权限检查等任务。

中间件可以被分配给路由或路由组,从而对特定的路由或一组路由的请求进行过滤和处理。这样可以将不同的功能分离到不同的中间件类中,使代码更加模块化、可维护和可扩展。

二、中间件的创建和使用示例

  1. 创建中间件

你可以使用 Artisan 命令来创建一个中间件:
php artisan make:middleware CheckAge

这将在 app/Http/Middleware 目录下生成一个名为 CheckAge.php 的文件。

以下是 CheckAge.php 的示例代码:

 
 
 
<?php

namespace App\Http\Middleware;

use Closure;

class CheckAge
{
    public function handle($request, Closure $next)
    {
        if ($request->age < 18) {
            return response('You must be at least 18 years old.', 403);
        }

        return $next($request);
    }
}
 

在上述代码中:

  • handle 方法是中间件的核心方法,它接收两个参数:$request(代表当前的 HTTP 请求)和 $next(一个闭包,代表将请求传递给下一个中间件或最终的路由处理程序)。
  • 首先,它检查请求中的 age 参数是否小于 18。如果是,则返回一个带有 403 Forbidden 状态码的响应。
  • 如果 age 大于或等于 18,则调用 $next($request),将请求传递给下一个中间件或路由处理程序继续处理。

  1. 注册中间件

要使用创建的中间件,需要在 app/Http/Kernel.php 中进行注册。你可以将其注册到 $routeMiddleware 数组中:
protected $routeMiddleware = [
    'check.age' => \App\Http\Middleware\CheckAge::class,
];

  1. 将中间件应用到路由

你可以将中间件应用到单个路由或路由组中。例如,将其应用到一个路由:
Route::get('/adult-content', function () {
    return 'This is adult content!';
})->middleware('check.age');

或者将其应用到一个路由组:

 
Route::middleware(['check.age'])->group(function () {
    Route::get('/adult-content-1', function () {
        return 'This is adult content 1!';
    });
    Route::get('/adult-content-2', function () {
        return 'This is adult content 2!';
    });
});

三、多个中间件的执行顺序

当多个中间件被分配给一个路由或路由组时,它们会按照定义的顺序依次执行。例如:
Route::middleware(['first', 'second', 'third'])->group(function () {
    Route::get('/protected', function () {
        return 'This is protected content.';
    });
});

在上述示例中,首先会执行 first 中间件,然后是 second 中间件,最后是 third 中间件,只有当所有中间件都调用了 $next($request) 时,才会最终到达路由处理程序。

四、全局中间件

如果你希望某个中间件对所有请求都生效,可以将其添加到 $middleware 数组中,例如:
protected $middleware = [
    \App\Http\Middleware\CheckForMaintenanceMode::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    // 可以在这里添加全局中间件
    \App\Http\Middleware\MyGlobalMiddleware::class, 
];

这样,MyGlobalMiddleware 将在每个请求处理之前被调用。

五、中间件参数

有时你可能需要向中间件传递参数,以下是一个示例:

Route::middleware('check.age:21')->get('/vip-content', function () {
    return 'This is VIP content!';
});

在中间件类中,你可以接收这个参数:

 
public function handle($request, Closure $next, $age = 18)
{
    if ($request->age < $age) {
        return response('You must be at least '.$age.' years old.', 403);
    }

    return $next($request);
}

在上述代码中,我们在路由中传递了参数 21 给 check.age 中间件,中间件的 handle 方法接收了这个参数,这样就可以根据不同的路由设置不同的年龄限制。

六、终止中间件

有时你可能需要在响应发送给客户端之后执行一些操作,这时可以使用 terminate 方法:

 
 
 
class LogAfterRequest
{
    public function handle($request, Closure $next)
    {
        $response = $next($request);
        // 这里添加在请求处理过程中的逻辑
        return $response;
    }

    public function terminate($request, $response)
    {
        // 这里添加在响应发送给客户端之后的逻辑,比如日志记录等
        Log::info('Request processed at '.date('Y-m-d H:i:s'));
    }
}
 

在 app/Http/Kernel.php 中注册该中间件:
protected $middleware = [
    // 其他中间件
    \App\Http\Middleware\LogAfterRequest::class,
];

通过上述的解释和示例,你应该对 Laravel 中间件有了一个比较全面的了解,包括如何创建、注册、使用中间件,如何设置多个中间件的执行顺序,如何使用中间件参数,以及如何使用终止中间件进行后续操作。这些特性使得 Laravel 中间件成为构建复杂和可维护的 Web 应用程序的强大工具。
 
 
使用 Ctrl+D 可将网站添加到书签
收藏网站
扫描二维码
关注早实习微信公众号
官方公众号
Top