Thinkphp6.0中间件的具体使用

全局中间件

全局中间件是在app\middleware.php中定义的中间件，默认没有启用任何中间件，但对支持的系统中间件做了注释，你只需要取消注释就可以使用相应的系统中间件，默认内容如下：


return [
    // 全局请求缓存
    // 'think\middleware\CheckRequestCache',
    // 多语言加载
    // 'think\middleware\LoadLangPack',
    // Session初始化
    // 'think\middleware\SessionInit',
    // 页面Trace调试
    // 'think\middleware\TraceDebug',
];

系统的部分功能交给中间件进行统一管理，包括全局请求缓存、多语言的自动检测和加载、Session初始化和页面Trace调试，也就是说，默认安装后的应用是不支持Session的，你必须全局开启Session初始化中间件后Session才能生效。对于API应用来说，本身就不需要Session功能支持。

你可以在全局中间件定义文件中添加你的应用中间件，但尽可能确保系统中间件的优先执行，中间件定义需要使用完整的类名，通过命令行指令可以快速创建一个应用中间件：

php think make:middleware Test

会自动生成一个app\middleware\Test中间件类，内容如下：


<?php
namespace app\middleware;
class Test
{
    public function handle($request, \Closure $next)
    {
    }
}

也支持通过指定完整命名空间的方式创建中间件类

php think make:middleware app\middleware\Hello

我们添加一个测试输出


<?php
namespace app\middleware;
class Test
{
    public function handle($request, \Closure $next)
    {
     echo 'Before Middleware<br/>';
     $response = $next($request);
     echo 'After Middleware<br/>';
     return $response;
    }
}

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

然后在全局中间件定义中添加


return [
 \app\middleware\Test::class,
];

假设我们要访问的控制器方法为


<?php
namespace app\controller;
class Index
{
    public function hello()
    {
     return 'Hello,ThinkPHP!<br/>';
    }
}

访问该操作方法的输出为

Before Middleware
Hello,ThinkPHP!
After Middleware

你可以看出中间件的执行过程，从执行流程上可以分为前置中间件和后置中间件，当然，一个中间件可能同时有前置和后置行为，上面的Test中间件就是如此。 $next($request)之前的代码属于前置中间件范畴，之后的代码则属于后置中间件范畴。

应用中间件

如果是多应用模式的话，应用中间件就是在app\应用名\middleware.php中定义的中间件，只会在该应用下有效，定义格式和全局中间件一致。

路由中间件

路由中间件则表示仅在路由匹配之后才会执行某个中间件，在路由定义中使用middleware方法定义，例如：


Route::get('hello/:name','index/hello')
    ->middleware(\app\middleware\Hello::class);

可以给路由分组定义中间件


Route::group(function(){
 Route::get('hello/:name','index/hello');
 //...
})->middleware(\app\middleware\Hello::class);

如果要执行多个中间件，可以使用


Route::group(function(){
 Route::get('hello/:name','index/hello');
 //...
})->middleware([\app\middleware\Hello::class,\app\middleware\Check::class]);

对于经常要使用的中间件，我们可以定义一个别名，在config\middleware.php配置文件中，设置

php think make:middleware Test0

路由定义可以改为：

php think make:middleware Test1

支持给一组中间件定义别名

php think make:middleware Test2

路由定义可以改为

php think make:middleware Test3

中间件支持传入一个参数，中间件定义如下

php think make:middleware Test4

可以在路由中间件的第二个参数传入name参数

php think make:middleware Test5