v6.0.0-rc5
版本发布时间: 2019-10-14 11:01:32
top-think/framework最新发布版本:v8.0.4(2024-07-30 09:55:55)
主要更新包括:
多应用模式调整
鉴于多应用模式的复杂性和扩展性考虑,最新版本把多应用模式独立为框架的一个全局中间件扩展。默认安装后核心框架为单应用模式,如果需要使用多应用模式,可以安装
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
扩展,如果通过composer安装应用的话,默认会安装topthink/think-trace
扩展,或者直接安装。
composer require topthink/think-trace
原核心内置的
TraceDebug
中间件不再使用,请在中间件定义文件中注释掉。
基本用法和之前保持不变,但无需额外配置,默认使用html
方式显示,同时仍然支持浏览器控制台显示,并仅在调试模式下有效。
同时增加了一个基于debugbar
的调试扩展think-debugbar
,需要单独安装后才能使用。
composer require topthink/think-debugbar