版本要求：

从Thinkphp5.1.6+版本开始，正式引入中间件的支持。

目录

一、中间件的作用

二、定义中间件

1、前置中间件

2、后置中间件 

 三、注册中间件

1、路由中间件

2、全局中间件

3、模块中间件

4、控制器中间件 

5、使用闭包定义中间件

 四、给中间件传入参数

五、中间件向控制器传参数

---

一、中间件的作用

中间件主要用于拦截或过滤应用的HTTP请求，并进行必要的业务处理。比如可以使用中间件来检查用户的请求信息里是否包含一句话木马。

行为钩子和中间件的区别：

中间件：它是对项目请求做处理，在用户访问我们的项目时，中间件就可以对于这个请求来判断用户是否有权限，或者判断用户是否存在非法访问；

行为钩子：在某一动作开始或者结束的时候会触发的方法，比如用户注册成功记录日志；

中间件是对用户请求做处理，而钩子则是对用户动作的处理，中间件相当于过滤器，钩子相当于事件，都是采用AOP思想。

二、定义中间件

首先，可以通过cmd命令行指令快速生成中间件，在项目的根目录里执行以下cmd命令：

php think make:middleware Check

 这个指令会 application/http/middleware目录下面生成一个Check中间件，代码如下：

-meta"><?php
 
namespace app\http\middleware;
 
-class">class Check
{
    public function handle(-variable">$request, \Closure -variable">$next)
    {
        if (-variable">$request->param('name') == 'index') {
            return redirect('/');//重定向到首页
        }
 
        return -variable">$next(-variable">$request);//返回的是一个Response对象
    }
}

 中间件说明：

1、中间件的入口执行方法必须是handle方法，而且第一个参数是Request对象，第二个参数是一个闭包；

2、中间件handle方法的返回值必须是一个Response对象；

3、中间件里可以直接使用Request对象，获取请求参数；

4、在某些需求下，可以使用第三个参数传入额外的参数；

public function handle(-variable">$request, \Closure -variable">$next, -variable">$name){
    if (-variable">$name == 'index') {
        return redirect('/');//重定向到首页
    }
 
    return -variable">$next(-variable">$request);
}

1、前置中间件

前置中间件的意思就是，在http请求完成之前，先执行中间件的代码。

-meta"><?php
 
namespace app\http\middleware;
 
-class">class Before
{
    public function handle(-variable">$request, \Closure -variable">$next)
    {
        // 先执行中间件代码
        return -variable">$next(-variable">$request);
    }
}

2、后置中间件 

后置中间件的意思就是，在http请求完成之后，才开始执行中间件的代码。

-meta"><?php
 
namespace app\http\middleware;
 
-class">class After
{
    public function handle(-variable">$request, \Closure -variable">$next)
    {
		-variable">$response = -variable">$next(-variable">$request);
        //后执行中间件代码
        return -variable">$response;
    }
}

 三、注册中间件

1、路由中间件

顾名思义，就是指定在某个路由下才会去调用这个中间件，即用户访问了这个路由链接，就会执行这个中间件。

//用户登录的路由
Route::rule('login','index/User/login')->middleware('Auth');

 或者使用完整的中间件类名：

Route::rule('login','index/User/login')->middleware(app\http\middleware\Auth::-variable language_">class);

 说明：中间件的注册建议使用完整的类名，如果没有指定命名空间则默认使用app\http\middleware作为命名空间

同一个路由也支持注册多个中间件，只需要middleware()里用逗号隔开即可：

Route::rule('login','index/User/login')->middleware(['Auth', 'Check']);

Thinkphp5.1.8+ 版本后，支持对路由分组注册中间件，如下：

//一个名为user的路由分组
Route::group('user', function(){
	Route::rule('login','index/User/login');
    Route::rule('register','index/User/register');
})->middleware('Auth');

2、全局中间件

意思就是说，所有的（全局）http访问请求，都会自动调用这个中间件。

在application目录下创建middleware.php文件，代码如下：

-meta"><?php
return [
    //第1个中间件
	\app\http\middleware\Auth::-variable language_">class,
    //第2个中间件（Check中间件没有指定命名空间，所以会默认使用app\http\middleware作为命名空间）
    'Check',
];

3、模块中间件

Thinkphp5.1.8+版本以上支持模块中间件定义，你可以直接在模块目录下面增加middleware.php文件，定义方式和全局中间件定义一样，只是只会在该模块下面生效。 

4、控制器中间件 

Thinkphp5.1.17+版本以上支持为控制器定义中间件。首先你的控制器需要继承系统的think\Controller类，然后在控制器中定义middleware属性，例如：

-meta"><?php
namespace app\index\controller;
use think\Controller;
 
-class">class Index extends Controller{
 
    protected -variable">$middleware = ['Auth'];
 
    public function index()
    {
        return 'index';
    }
}

5、使用闭包定义中间件

在某些简单的场合，我们不需要使用中间件类，这时候可以使用闭包定义中间件，但闭包函数必须返回Response对象实例。 

Route::group('hello', function(){
	Route::rule('login','index/User/login');
})->middleware(function(-variable">$request,\Closure -variable">$next){
    if (-variable">$request->param('name') == 'index') {
        return redirect('/');//重定向到首页
    }    
	return -variable">$next(-variable">$request);
});

 四、给中间件传入参数

1、全局中间件传参数

-meta"><?php
return [
	[\app\http\middleware\Auth::-variable language_">class, '张三'],
    'Check:李四',
];

上面的定义表示给Auth中间件传入参数为张三，给Check中间件传入参数为李四

2、路由中间件传参数

(1)、给Auth中间件传入参数张三

Route::rule('login','index/User/login')->middleware('Auth:张三');

 也可以这样写：

Route::rule('login','index/User/login')->middleware(Auth::-variable language_">class, '张三');

（2）、给多个中间件传入同一个参数 

Route::rule('login','index/User/login')->middleware([Auth::-variable language_">class, 'Check'], '张三');

（3）、单独指定各个中间件的参数

Route::rule('login','index/user/login')->middleware(['Auth:张三', 'Check:李四']);

五、中间件向控制器传参数

前面讲的给中间件传入特定的参数 （常量），那么中间要如何向控制器传入参数呢？我们可以通过给Request请求对象赋值的方式传参给控制器（或者其它地方），例如：

-meta"><?php
namespace app\http\middleware;
 
-class">class Auth
{
    public function handle(-variable">$request, \Closure -variable">$next)
    {
        //给控制器传参数
        -variable">$request->result = '验证成功';       
        return -variable">$next(-variable">$request);
    }
}

需要特别注意：传递的变量名称不要和Request已有的参数变量名有冲突，比如用户登录请求的Request参数里已经有一个username，那么中间件向控制器传参，就不能再用这个username了，否则会改变原来参数的值。

然后在控制器的方法里面可以直接使用：

public function index(Request -variable">$request)
{
	return -variable">$request->result;
}