# HTTP 中间件
- [简介](#introduction)
- [创建中间件](#defining-middleware)
- [注册中间件](#registering-middleware)
- [全局中间件](#global-middleware)
- [为路由指定中间件](#assigning-middleware-to-routes)
- [中间件参数](#middleware-parameters)
- [Terminable 中间件](#terminable-middleware)
## 简介
HTTP 中间件提供了一个方便的机制来过滤进入应用程序的 HTTP 请求,例如,Auth 中间件验证用户的身份,如果用户未通过身份验证,中间件将会把用户导向登录页面,反之,当用户通过了身份验证,中间件将会通过此请求并接着往下执行。
当然,除了身份验证之外,中间件也可以被用来运行各式各样的任务,如:CORS 中间件负责替所有即将离开程序的响应加入适当的标头;而日志中间件则可以记录所有传入应用程序的请求。
Lumen 框架已经内置了一些中间件,包括维护、身份验证、CSRF 保护,等等。所有的中间件都放在 `app/Http/Middleware` 目录内。
## 创建中间件
你可以复制 Lumen 自带的中间件示例文件 `ExampleMiddleware` 里的内容来创建新的中间件。在这个中间件内我们只允许请求的年龄 `age` 变量大于 200 时才能访问路由,否则,我们会将用户重定向到首页「home」这个 URI 上。
input('age') <= 200) {
return redirect('home');
}
return $next($request);
}
}
如你所见,若是 age 小于 200,中间件将会返回 HTTP 重定向给用户端,否则,请求将会进一步传递到应用程序。只需调用带有 `$request` 的 `$next` 方法,即可将请求传递到更深层的应用程序(相当于允许通过中间件)。
HTTP 请求在实际碰触到应用程序之前,最好是可以层层通过中间件。每一层都可以对请求进行检查,甚至完全拒绝请求。
### 前置中间件 / 后置中间件
「前置中间件(BeforeMiddleware)」运行于请求处理之前:
译者注: 前置中间件运行的时间点是在每一个请求处理之前,可以参阅此文章加深理解:[如何查看 Laravel 5 的所有数据库请求](https://phphub.org/topics/2018)
这个中间件会在应用程序处理请求 **后** 运行它的任务:
## 注册中间件
### 全局中间件
若是希望每个 HTTP 请求都经过一个中间件,只要将中间件的类加入到 `bootstrap/app.php` 的 `$app->middleware()` 调用参数数组中。
$app->middleware([
App\Http\Middleware\OldMiddleware::class
]);
### 为路由指派中间件
如果你要指派中间件给特定路由,你需要给中间件设置一个好记的 `键`, 同样的,可以在 `bootstrap/app.php` 的 `$app->middleware()` 调用参数数组中进行设置。
$app->routeMiddleware([
'auth' => App\Http\Middleware\Authenticate::class,
]);
中间件一旦被定义,即可在路由选项内使用 `middleware` 键值指定:
$app->get('admin/profile', ['middleware' => 'auth', function () {
//
}]);
使用一组数组为路由指定多个中间件:
$app->get('/', ['middleware' => ['first', 'second'], function () {
//
}]);
## 中间件参数
中间件也可以接收自定义传参,例如,要在运行特定操作前检查已验证用户是否具备该操作的「角色」,可以创建 `RoleMiddleware` 来接收角色名称作为额外的传参。
附加的中间件参数将会在 `$next` 参数之后被传入中间件:
user()->hasRole($role)) {
// 重定向...
}
return $next($request);
}
}
在路由中可使用冒号 `:` 来区隔中间件名称与指派参数,多个参数可使用逗号作为分隔:
$app->put('post/{id}', ['middleware' => 'role:editor', function ($id) {
//
}]);
## Terminable 中间件
有些时候中间件需要在 HTTP 响应被发送到浏览器之后才运行,例如,「session」中间件存储的 session 数据是在响应被发送到浏览器之后才进行写入的。想要做到这一点,你需要定义中间件为「terminable」。