### 2019 年 6 月 9 日 发布
6.0中间件分为系统中间件和应用中间件，系统中间件为核心框架内置的中间件，应用中间件是在应用里面创建的中间件。
>[danger] 中间件的主要应用场景可以包括对HTTP请求的数据过滤、权限检测、请求拦截等行为，使用中间件能够让控制器的定义更加简单，很多额外的非核心业务流程的处理都可以交给中间件执行。
从中间件的使用范围来看，可以分为全局中间件、应用中间件、控制器中间件和路由中间件。
## 全局中间件
全局中间件是在`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;
}
}
```
>[danger] 中间件`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`配置文件中，设置
```
return [
'hello' => \app\middleware\Hello::class,
'check' => \app\middleware\Check::class,
];
```
路由定义可以改为：
```
Route::group(function(){
Route::get('hello/:name','index/hello');
//...
})->middleware(['hello','check']);
```
支持给一组中间件定义别名
```
return [
'test' => [\app\middleware\Hello::class,\app\middleware\Check::class],
];
```
路由定义可以改为
```
Route::group(function(){
Route::get('hello/:name','index/hello');
//...
})->middleware('test');
```
中间件支持传入一个参数，中间件定义如下
```
<?php
namespace app\middleware;
class Hello
{
public function handle($request, \Closure $next, string $name = '')
{
echo 'Hello'. $name . '<br/>';
return $next($request);
}
}
```
可以在路由中间件的第二个参数传入name参数
```
Route::get('hello/:name','index/hello')
->middleware('hello', 'middleware');
```
除了支持参数外，你可以在中间件的handle方法中使用依赖注入。
## 控制器中间件
控制器中间件仅当访问某个控制器的时候生效
```
<?php
namespace app\controller;
class Hello
{
protected $middleware = ['hello','check'];
public function index()
{
return 'Hello,ThinkPHP!<br/>';
}
}
```
由于前面已经定义了中间件别名，所以这里直接使用别名定义，否则你必须使用完整的命名空间定义。
默认情况下，控制器中定义的中间件访问控制器的任何操作方法都会执行，有时候并不希望所有的操作都需要执行中间件，有两种方式来定义控制器中间件的执行过滤。
```
<?php
namespace app\controller;
class Index
{
protected $middleware = [
'hello' => ['only' => ['hello']],
'check' => ['except'=> ['hello']],
];
public function hello()
{
return 'Hello,ThinkPHP!<br/>';
}
public function check()
{
return 'this action require check!<br/>';
}
}
```
`hello`中间件仅在执行`Index`控制器的`hello`操作的时候才会执行，而`check`中间件除了`hello`方法外，都会执行，具体效果你可以实际测试下。
## 中间件传参
中间件和控制器之间传参的方式有很多，一个简单的方法是使用Request来进行传参。
~~~
<?php
namespace app\middleware;
class Hello
{
public function handle($request, \Closure $next)
{
$request->hello = 'ThinkPHP';
return $next($request);
}
}
~~~
中间件向控制器传参必须在前置中间件完成，后置中间件向控制器的传参控制器无法接收。
然后在控制器的方法里面可以直接使用
~~~
public function index(Request $request)
{
return $request->hello; // ThinkPHP
}
~~~
- 值得升级到5.1的18个理由
- 5.1.7版本新特性
- JSON字段类型在ORM中的使用
- 文件下载响应对象
- 教你使用5.1的数组对象查询
- 模型三大利器之一：搜索器
- 在ThinkPHP中使用Yaconf
- 掌握命令行的表格输出
- 5.1.25查询参数绑定的改进
- ThinkPHP安全规范指引
- 巧用数据集的排序功能实现统计排序
- think-orm ——基于5.1的独立ORM库
- think-template——基于ThinkPHP的独立模板引擎
- ThinkPHP5.1.26版本发布——修正版本，包含安全更新
- ThinkPHP5.0和3.2再发安全更新
- 官宣：ThinkPHP发布首个LTS版本
- 你真的了解Db类和模型的正确使用姿势么？
- 如何更有效的记录和管理日志
- 模型三大利器之二：修改器
- ThinkPHP5.1.28版本发布——修正上一版本问题，改进关联查询
- 模型三大利器之三：获取器
- API版本控制的几种思路
- ThinkPHP5.2第一个Beta版本发布测试
- 让你少犯错的数据查询基本原则
- ThinkPHP发布5.1.29版本——常规更新
- 这15个好习惯让你更容易升级到5.2
- 如何有效提高ThinkPHP的应用性能
- 让你提高开发效率的查询技巧
- 模型关联查询不完全指南
- 5.2发布Beta2版本——统一和精简大量用法
- ThinkPHP发布5.1.30版本——支持微秒时间字段写入
- ThinkPHP的数据缓存使用
- ThinkPHP5.2安装及入口文件
- ThinkPHP荣获2018 年度最受欢迎中国开源开发框架第1名
- 5.1路由使用心得技巧
- ThinkPHP5.*版本发布安全更新
- ThinkPHP项目及代码规范指北
- 5.2版本的设计规范指导
- ThinkPHP5.1.32版本发布——圣诞快乐
- 利用Trait特性给模型增加乐观锁功能
- 5.2数据库和模型的变化（摘要）
- ThinkPHP模板引擎实现和常见问题
- ThinkPHP5.0.24版本发布——安全更新
- 不忘初心，方得始终——ThinkPHP十三周年报告
- ThinkPHP5+相关资源汇总
- 异步社区ThinkPHP周年庆专享优惠活动
- 5.2路由的调整和改进
- ThinkPHP发布5.1.33版本——包含安全更新
- ThinkPHP扩展开发指南
- ThinkPHP发布5.2Beta3版本
- ThinkPHP发布5.1.34版本——喜迎新年
- ThinkPHP发布5.2RC1版本
- ThinkPHP发布5.1.35版本——常规更新
- 5.2配置类的调整
- 5.2时间查询的改进和优化
- 5.2RC版本升级不完全指导（仅供学习参考）
- ThinkPHP5.2版本正式变更为6.0版本
- ThinkPHP百度云云虚拟主机专享免费活动
- 事件系统以及查询事件、模型事件的使用
- ThinkPHP6.0RC2版本发布——架构升级、精简核心
- ThinkPHP5.1.36LTS版本发布——常规更新
- 新版Session和Cookie设计变化
- ThinkPHP5.1.37版本发布——常规更新
- ThinkPHP6.0RC3版本发布——细节完善，体验优化
- 6.0中间件使用详解
- Composer各大厂商镜像地址
- ThinkPHP6.0发布计划公告
- 「ThinkPHP开发者周刊」招募志愿者
- ThinkPHP6.0日志变化
- ThinkPHP5.1.38版本发布——常规更新
- ThinkPHP6.0RC4版本发布——ORM独立，日志多通道支持
- ThinkORM2.0开发指南上线
- ThinkPHP6.0RC5版本发布——多应用模式独立，中间件机制调整
- ThinkPHP6.0版本发布——程序员节福利
- ThinkPHP5.1.39LTS版本发布——常规更新
- ThinkPHP6.0.1版本发布——圣诞快乐！
- 回顾2019，展望2020！
- ThinkPHPV6.0.2版本发布——2020新春快乐！
- 周年福利系列：Swoole合作优惠
- 亿速云成为ThinkPHPV6.0独家赞助发布商🎉
- 新冠疫情工具和限免资源专题（保持更新中）
- 周年福利系列：创宇信用认证合作优惠
- 周年福利系列：码云企业版限时10%优惠
- 周年福利系列：想天短说抵现优惠
- think-swoole直播：从零开始掌握swoole开发
- 周年福利系列：B2C开源电商ShopXO授权8折优惠
- 周年福利系列：LayuiAdmin 永久授权限时优惠
- ThinkPHP资源导航站上线——构建生态 服务未来
- ThinkPHP官方技术支持服务和应用服务市场上线公测
- ThinkPHP市场精选——推广基本要素
- ThinkPHP市场精选——客服聊天专题
- ThinkPHPV6.0.3版本发布——端午安康
- ThinkPHP开发者扶持计划
- 6.0.3版本关键更新及升级事项
- 「ThinkPHP开发者周刊」改版重启
- ThinkPHP市场精选——企业建站专题
- ThinkPHP 提供统一API接口服务
- ThinkPHP市场精选——直播电商专题
- ThinkAPI服务SDK发布
- 官方服务市场启用独立子域名
- ThinkPHP市场精选——刷脸支付专题
- ThinkAPI推出会员服务计划
- ThinkPHPV6.0.4版本发布——中秋国庆双节快乐
- ThinkPHPV5.1.40版本发布——常规更新
- 1024程序员节福利走一波
- ThinkPHP V6.0.5版本发布——兼容Composer2.0
- 知识图谱应用场景——源论技术沙龙
- ThinkPHP5.*版本改进Composer2.0的兼容
- 官方市场双十一精选推荐
- 技术人做产品有机会么（文末送课程）
- 本周秒杀——古德云售后获客营销系统
- ThinkAPI服务更新——支持接口分组和PHP版本依赖调整
- PHP8新特性盘点
- PHP8新特性系列：构造器属性提升使用及注意事项
- ThinkPHP2021新年寄语
- ThinkPHP V6.0.6&V5.1.41版本发布——兼容PHP8.0
- PHP如何更优雅地调用API接口
- ThinkPHP V6.0.7发布——修正版本
- ThinkAPI服务更新——IP白名单
- 最新版ThinkORM对于时间字段的调整
- ThinkAPI短信接口正式上线
- ThinkPHP V6.0.8版本发布——多环境变量配置支持
- 顶想云写作服务开启第一次公测
- ThinkSSL上线——官方SSL/TLS证书服务
- MDBootstrap国内用户福利——ThinkPHP官方市场首发
- ThinkPHP V6.0.9版本发布——常规更新
- ThinkORM功能盘点——虚拟模型
- 全面支持主流GIT版本库——云写作服务第二次公测
- 云写作服务私有化部署方案之：版本库私有化
- 看云双十一活动
- ThinkPHP V6.0.10LTS发布——兼容PHP8.1
- ThinkPHP V6.0.12发布——命令行兼容8.1
- 顶想云知识管理上线公测——构建企业文档中心和知识库
- 顶想云上线——助力生态数字化建设
- 618活动进行中——官方市场迎来一波更新
- 顶想云知识管理正式上线——看云文档启动迁移服务
- ThinkPHP V6.0.13发布——常规更新
- 顶想云网站助理服务上线——构建产品支持服务
- ThinkPHP发布6.1.0&6.0.14版本——安全更新
- ThinkPHP新版社区上线试运营
- ThinkAPI上架人脸核身接口——助力网站实名认证
- 辞旧迎新——旧版社区停止注册及发帖
- ThinkPHP6.1.2版本发布——兼容PHP8.2