ThinkPHP6.0RC5版本发布——多应用模式独立，中间件机制调整 · ThinkPHP官方博客

### 2019 年 10 月 13 日发布 ThinkPHP最新的`6.0`版本原计划于国庆左右发布，由于国庆期间本着核心精简的原则对多应用模式做了一些调整，为了避免可能的问题还需要做更充分的测试，加上新版框架的安全审计工作仍然还在继续，所以在计划之外额外发布了一个`RC5`积累更新版本，正式版本的发布日期推迟到10月24日。 >[danger] 官方本着认真和严谨的态度对待此次ThinkPHP`6.0`的发布工作，我们希望交付给开发者的新版是一个更好用而且架构稳定的版本，相信这是一个值得等待的框架。下面是`RC5`版本自`RC4`之后的主要更新，基本上不影响之前版本的升级，并且官方完全开发手册的内容已经同步更新。 ## 多应用模式调整鉴于多应用模式的复杂性和扩展性考虑，最新版本把多应用模式独立为框架的一个全局中间件扩展。默认安装后核心框架为单应用模式，如果需要使用多应用模式，可以安装 ``` composer require topthink/think-multi-app ``` 安装后会自动注册一个全局中间件并优先执行，就可以自动支持多应用模式，无需做任何的配置调整。如果需要进行应用映射或者域名绑定的话，仍然设置`app_map`以及`domain_bind`即可。如果你的入口文件是`index.php`的话，会自动开启自动多应用模式。如果你的入口文件是其它，例如`admin.php`或者`api.php`则会自动绑定`admin`或者`api`应用，当然，如果你在入口文件中已经使用`name`方法绑定了应用，则优先。另外，如果是自动多应用模式下，URL里面的应用不存在，会自动处理为单应用解析，也就是说多应用和单应用是可以在新版的架构下共存。举个例子，当我们访问下面的URL： ``` http://tp.com/think ``` 假设`think`应用并不存在（也没有定义任何的应用映射），当我们访问上面的地址的时候会自动进行单应用解析，也就是说如果有定义全局路由（例如`route/route.php`）的话 ``` Route::get('think', function () { return 'hello,ThinkPHP!'; }); ``` 页面会输出 ~~~ hello,ThinkPHP! ~~~ 这样设计的初衷是为了更加方便扩展注册全局路由，避免在开启多应用模式的情况下注册的全局路由失效（比如之前的验证码扩展只能用于单应用模式，多应用模式需要单独注册路由）。如果你完全不需要单应用模式，也可以设置使用严格的多应用模式 ``` 'app_express' => true, 'default_app' => 'home', ``` 当我们再次访问 ``` http://tp.com/think ``` 的时候，其实是访问默认（`home`）应用的`think`路由。 ## 中间件机制改进由于多应用扩展独立后，中间件机制也随之进行了一些优化和调整，现在中间件大致分为四个组，包括全局中间件、应用中间件、路由中间件和控制器中间件，每个中间件组彼此独立按顺序运行。在`app/middleware.php`文件里面定义的中间件即为全局中间件，执行优先级最高（相对于前置中间件而言），如果使用了多应用模式，并且在应用目录下也定义了`middleware.php`文件，即为应用中间件，执行优先级仅次于全局中间件。如果在路由注册的时候定义了中间件即为路由中间件，注意，在路由中间件执行之前是获取不到当前应用的控制器和操作名的（所以，全局中间件和应用中间件执行的过程中是无法获取控制器和操作名的），如果你不想在路由注册的时候定义中间件，还有一个额外的办法，就是在路由配置文件（包括全局路由配置和应用路由配置）中定义`middleware`参数，无论是否匹配路由都会执行，类似于全局路由中间件的概念。 ~~~ 'middleware' => [ app\middleware\Auth::class, app\middleware\Check::class, ], ~~~ ## 中间件调度优化中间件的执行流程改进，`think\middleware`仅仅负责中间件的管理和调度，增加`think\Pipeline`类负责中间件的执行。并支持控制中间件的执行顺序。中间件配置文件的格式做了一些调整，除了定义中间件别名外，增加了执行优先级设置。 ``` return [ // 别名或分组 'alias' => [ ], // 优先级设置，此数组中的中间件会按照数组中的顺序优先执行 'priority' => [ ], ]; ``` ## 中间件`end`回调中间件增加`end`回调，如果在中间件类中有定义`end`方法，则会在请求结束后统一调用。 ``` public function end(Response $response) { } ``` ## 中间件执行去重对于每个分组的中间件，会进行强制去重操作，也就是说在一个分组中的中间件只可能执行一次。 ## 模板目录自动识别模板目录无需再进行任何的配置，取消了`view_base`配置，改为自动识别，应用目录下的`view`目录优先，如果不存在，则会使用应用根目录下的`view`目录。如果要单独定义某个应用的模板目录，则使用`view_path`配置参数定义即可。 ## 事件智能订阅改进事件智能订阅的时候不再需要事先注册和定义事件，采用反射机制自动识别订阅事件。 ## 应用名获取调整多应用模式改成扩展后，核心已经完全解耦了多应用相关的方法和属性，所以如果你需要获取当前的应用名，需要改成 ``` app('http')->getName(); ``` 对于使用中间件进行权限控制用途的，官方的建议是采用`pathinfo`地址进行权限判断。 ## `think-swoole`扩展更新 `think-swoole`扩展也在持续更新和完善，现在已经支持数据库和缓存的连接池功能，以及RPC功能。 ## 调试工具更新原来内置的页面Trace调试工具已经更改为扩展的方式，改成安装[`think-trace`](https://github.com/top-think/think-trace)扩展，如果通过composer安装应用的话，默认会安装`topthink/think-trace`扩展，或者直接安装。 ``` composer require topthink/think-trace ``` >[danger] 原核心内置的`TraceDebug`中间件不再使用，请在中间件定义文件中注释掉。基本用法和之前保持不变，但无需额外配置，默认使用`html`方式显示，同时仍然支持浏览器控制台显示，并仅在调试模式下有效。同时增加了一个基于[`debugbar`](http://phpdebugbar.com/)的调试扩展[`think-debugbar`](https://github.com/top-think/think-debugbar)，需要单独安装后才能使用。 ``` composer require topthink/think-debugbar ``` ## 关于官网的升级重构最后一个是关于官网的消息，为了迎接新版的发布，ThinkPHP官网这次终于要更新了。官方计划在本月对旧版（史前）官网进行ThinkPHP`6.0`的升级重构，同时改进用户体验和手机阅读体验。