菜单
本页目录

定义中间件

介绍

中间件提供了一种方便的机制来过滤进入应用程序的 HTTP 请求。例如,Laravel 包含一个验证用户身份的中间件。 如果用户未能通过认证,中间件会把用户重定向到登录页面。 反之,用户如果通过验证, 中间件将把请求进一步转发到应用程序中。 当然,除了验证身份外,还可以编写其他的中间件来执行各种任务。例如:CORS 中间件可以负责为所有的应用返回的 responses 添加合适的响应头。日志中间件可以记录所有传入应用的请求。 Laravel 自带了一些中间件,包括身份验证、CSRF 保护等。所有的这些中间件都位于app/Http/Middleware 目录。

定义

您可以使用 make:middleware 来创建一个中间件:

php artisan make:middleware 中间件名

该命令会在 app/Http/Middleware 目录下放置新的 CheckAge 类。在这个中间件中,我们仅允许 age 参数大于 200 的请求对路由进行访问,否则将重定向到 home 页面:

<?php
namespace App\Http\Middleware;
class CheckAge
{
    /**
     * 处理传入的请求
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, \Closure $next)
    {
        if ($request->age <= 200) {
            return redirect('/home');
        }
        return $next($request);
    }
}

如果给定的 age 参数小于或等于 200, 这个中间件将返回一个 HTTP 重定向给客户端;否则这个请求将会通过,进一步传递到应用层中。要让请求继续传到到应用层中 (即允许 「通过」中间件验证), 只需要将 $request 作为参数来调用函数 $next 即可。