## 中间件
中间件主要用于拦截或过滤应用的 HTTP 请求,并进行必要的业务处理,通常使用在登录验证的场景。
## 定义中间件
源码中默认自带了两个中间件,一个前置,一个后置。
>[success] - 中间件类名必须带 Middleware 后缀。
> - 配置文件 main.php 中可定义中间件目录的命名空间。
### 前置中间件
如果想拦截请求不往下执行,只需在 $next() 前 return 响应内容即可。
~~~
namespace apps\index\middleware;
/**
* 前置中间件
* @author 刘健
*/
class BeforeMiddleware
{
public function handle($callable, \Closure $next)
{
// 获取控制器与方法名称,可做细粒度的权限控制
list($controller, $actionName) = $callable;
$controllerName = get_class($controller);
// 添加中间件执行代码
// ...
// 执行下一个中间件
return $next();
}
}
~~~
### 后置中间件
~~~
namespace apps\index\middleware;
/**
* 后置中间件
* @author 刘健
*/
class AfterMiddleware
{
public function handle($callable, \Closure $next)
{
// 获取后面全部中间件执行后的响应结果
$response = $next();
// 添加中间件执行代码
// ...
// 返回响应内容
return $response;
}
}
~~~
## 注册中间件
### 全局中间件
配置文件 `main.php` 中的 `middleware` 配置项目可配置全局中间件,全局中间件是全局有效的,对任何路由都有效。
~~~
// 全局中间件
'middleware' => ['After'],
~~~
>[info] 配置时不需要加 Middleware 后缀。
### 路由中间件
我们也可以在路由中为某一个路由规则配置要执行的中件间,如下:
~~~
// 路由规则
'rules' => [
// 一级路由
':controller/:action' => [':controller', ':action', 'middleware' => ['Before']],
],
~~~
### 如果我们需要排除某些路由规则不使用中间件
只需要在 **带通配符规则的前面** 增加一条不带 middleware 配置的路由。
~~~
// 路由规则
'rules' => [
// 首页不使用中间件
'' => ['Index', 'Index'],
// 一级路由中URL /profile/userinfo 不使用中间件
'profile/userinfo' => ['Profile', 'Userinfo'],
// 一级路由
':controller/:action' => [':controller', ':action', 'middleware' => ['Before']],
],
~~~