中间件

未匹配的标注
本文档最新版为 8.5,旧版本可能放弃维护,推荐阅读最新版!

中间件

介绍

中间件为过滤进入应用程序的HTTP请求提供了一种方便的机制。例如,Laravel 内置了一个中间件来验证用户的身份认证。如果用户没有通过身份认证,中间件会将用户重定向到登录界面。但是,如果用户被认证,中间件将允许该请求进一步进入该应用。

当然,除了身份认证以外,还可以编写另外的中间件来执行各种任务。例如:CORS 中间件可以负责为所有离开应用的响应添加合适的头部信息;日志中间件可以记录所有传入应用的请求。

Laravel 自带了一些中间件,包括身份验证、CSRF 保护等。所有这些中间件都位于 app/Http/Middleware 目录。

定义中间件

通过运行 make:middleware Artisan 命令来创建新的中间件:

php artisan make:middleware CheckAge

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

<?php

namespace App\Http\Middleware;

use Closure;

class CheckAge
{
    /**
     * Handle an incoming request.
     *
     * @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
最好将中间件想象为一系列 HTTP 请求,必须经过才能进入你应用的「层」。每一层都会检查请求(是否符合某些条件),(如果不符合)甚至可以(在请求访问你的应用之前)完全拒绝掉。

{提示} 所有的中间件都是通过 服务容器,因此,可以在你的中间件的构造函数中键入你需要的任何依赖。

前置 & 后置中间件

中间件是在请求之前或之后执行,取决于中间件本身。例如,下面的中间件将在应用处理请求 之前 执行某些任务:

<?php

namespace App\Http\Middleware;

use Closure;

class BeforeMiddleware
{
    public function handle($request, Closure $next)
    {
        // 执行动作

        return $next($request);
    }
}

而接下来的中间件将在应用请求 之后 执行某些任务:

<?php

namespace App\Http\Middleware;

use Closure;

class AfterMiddleware
{
    public function handle($request, Closure $next)
    {
        $response = $next($request);

        // 执行动作

        return $response;
    }
}

注册中间件

全局中间件

如果你希望中间件在应用处理每个 HTTP 请求期间运行。只需要在 app/Http/Kernel.php 中的 $middleware 属性中列出这个中间件。

为路由分配中间件

假设你想为指定的路由分配中间件,首先应该在 app/Http/Kernel.php 文件内为该中间件分配一个键。默认情况下,该类中的 $routeMiddleware 属性下包含了 Laravel 内置的中间件。若要加入自定义的中间件,只需把它附加到列表后并为其分配一个自定义键即可。例如:

// 在 App\Http\Kernel 类中...

protected $routeMiddleware = [
   'auth' => \App\Http\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
    'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
];

一旦在 HTTP 内核中定义好了中间件,就可以通过 middleware 方法将为路由分配中间件:

Route::get('admin/profile', function () {
    //
})->middleware('auth');

你也可以为路由分配多个中间件:

Route::get('/', function () {
    //
})->middleware('first', 'second');

分配中间件时,你还可以传递完整的类名:

use App\Http\Middleware\CheckAge;

Route::get('admin/profile', function () {
    //
})->middleware(CheckAge::class);

中间件组

某些时候你可能希望使用一个键把多个中间件打包成一个组,方便将他们应用到路由中。你可以使用 Http 核心的 $middlewareGroups 属性。

Laravel 内置了开箱即用的 webapi 中间件组,其中包含你可能希望应用于 Web UI 和 API 路由的常用中间件:

/**
 * 应用程序的路由中间件组
 *
 * @var array
 */
protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
        \Illuminate\Routing\Middleware\SubstituteBindings::class,
    ],

    'api' => [
        'throttle:60,1',
        'auth:api',
    ],
];

可以使用与单个中间件相同的语法将中间件组分配给路由和控制器动作。 同样,中间件组可以更方便地同时为路径分配多个中间件:

Route::get('/', function () {
    //
})->middleware('web');

Route::group(['middleware' => ['web']], function () {
    //
});

{提示} RouteServiceProvider 默认将 web 中间件组自动应用到 routes/web.php

中间件参数

中间件也可以接收额外的参数。例如,如果你的应用需要在执行一个特定操作之前验证用户是否为给定的「角色」,你可以创建一个 CheckRole 中间件,由它来接收「角色」名称作为附加参数。

附加的中间参数应该在 $next 参数之后传递给中间件:

<?php

namespace App\Http\Middleware;

use Closure;

class CheckRole
{
    /**
     * 处理传入的参数。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string  $role
     * @return mixed
     */
    public function handle($request, Closure $next, $role)
    {
        if (! $request->user()->hasRole($role)) {
            // 重定向
        }

        return $next($request);
    }

}

定义路由时通过一个 : 来隔开中间件名称和参数来指定中间件参数。多个参数就使用逗号分隔:

Route::put('post/{id}', function ($id) {
    //
})->middleware('role:editor');

Terminable 中间件

有时中间件可能需要在 HTTP 响应构建完毕之后处理一些工作。比如,Laravel内置的「session」中间件会在响应构建完毕之后将会话数据写入存储器中。如果你在中间件中定义了一个 terminate 方法,则会在响应构建完毕后,准备发往浏览器之前自动调用:

<?php

namespace Illuminate\Session\Middleware;

use Closure;

class StartSession
{
    public function handle($request, Closure $next)
    {
        return $next($request);
    }

    public function terminate($request, $response)
    {
        // 储存 session 数据...
    }
}

terminate 方法应该同时接收请求和响应。定义了这个中间件之后,别忘了将它添加到路由列表或者 app/Http/Kernel.php 文件的全局中间件中。

在你的中间件上调用 terminate 方法时,Laravel 会从 服务容器 中解析出一个新的中间件实例。如果你想在相同的中间件实例中同时调用 handleterminate 方法,请使用容器的 singleton 方法向容器中注册中间件。

本文章首发在 LearnKu.com 网站上。

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
上一篇 下一篇
Summer
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
贡献者:8
讨论数量: 8
发起讨论 只看当前版本


自由飞
terminable 中间件?
3 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
阿伦
auth 和 auth.basic 这两个中间件的区别?
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.6
FRKER
创建中间件错误?
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.6
clogcabin
Laravel5.7 中间件变动
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.7
lmaster
关于中间件的疑问?
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.6
不负韶华。
小错误?
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.6
circle
小 bug?
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.6
onion
链接错误.?
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.6