NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #3339 most downloaded on Packagist
The ThinkPHP Framework.
Latest stable
v8.1.4
Last release 10 months ago
15 Jan 2026
Ships fairly regularly
a new release about every 3 months
Most releases are documented
notes for 51 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
120 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
- 改进Config类hook方法 增加key参数 - 调整Config类lazy方法 - 修正路由url生成 - 兼容PHP8.5调整 - 新增 optimize 命令 - 改进Request类 - 优化日志文件删除顺序 - 调整"psr/http-message"增加"^2.0" - 优化 PH
核心移出ClassNotFoundException异常,直接使用 think-container 中的异常类
ClassNotFoundException异常,直接使用 think-container 中的异常类ModelService兼容orm4.0CallbackDispatchheader请求过滤检测方法version方法用于版本控制检测withoutmiddleware对自动layer中间件的支持LogRecord记录时间信息group方法用法name生成php think optimize:config 指令php think route:list和php think optimize:route指令,支持分组子目录规则Your coding agent can read these notes before it upgrades. Set up the MCP server →
增加ValidateRuleSet类 用于更方便的进行数组验证
ValidateRuleSet类 用于更方便的进行数组验证prefix参数 (用于是否自动prefix 默认为true)rules方法定义验证规则( 返回数组或验证对象)selfappend、middleware方法多次调用must 属性设置必须验证的字段不生效dateFormat验证规则auto_detect_browser参数Response增加getCookie方法Validate和Container组件移出核心并独立依赖- 完善 PHP 8.4 兼容性 - 改进parseUrl方法 - 改进验证类getError方法 - 分组绑定自动添加prefix - 改进路由到类的方法的时候 支持控制器中间件 - 自动识别路由到类的layer并支持自动中间件
增加路由预定义变量规则 当变量规则为整数或浮点数的时候 自动转换类型
8.4兼容支持when路由变量验证方法action_bind_param参数 设置操作方法的参数绑定方式json的判断Validate增加accepted、acceptedIf、declined、declinedIf、multipleOf内置规则cookie设置可以在当前请求生效withoutmiddleware方法用于排除某个路由的中间件getKey方法 获取错误字段名invokeAfter位置only方法支持强制类型转换must属性设置该验证类的必须验证字段 无论是否定义require规则fail_delete配置参数 用于在获取缓存发生异常的时候是否强制删除default参数支持传入闭包pull方法判断,并增加default参数Macroable方法注入功能serialize/unserialize方法8.4异常类增加AlwaysErrorMsg注解支持 明确指定是否需要输出错误信息
主要更新:
- 改进remember方法的有效期兼容性 - 为requre获取参数方法指定正确的filter类型 - 取消缓存读取和写入次数计数 废弃相关方法 - 兼容低版本的psr/log、psr/simple-cache - 改进路由的cache方法参数类型 - 异常页面手册地址调整
改进版本号获取指令(App类VERSION常量废弃) 修正Http类dispatchToRoute方法 改进请求对象获取根域名方法 Feat: 自动获取 php 命令路径,而不是固定用 php fix: is_executable() 的参数不正确 直接使用 PHP_BINARY 常量 Cache类
改进版本号获取指令(App类VERSION常量废弃) 修正Http类dispatchToRoute方法 改进请求对象获取根域名方法 Feat: 自动获取 php 命令路径,而不是固定用 php fix: is_executable() 的参数不正确 直接使用 PHP_BINARY 常量 Cache类set方法有效期参数兼容DateTimeInterface参数 修正Log/Channel类
Nothing published for this version
增加startWith、endWith及contain验证规则
8.0版本后续会陆续更新其它功能,6.0/6.1版本将不再做新功能更新,仅限BUG修正和安全更新。
8.0版本开始官方手册启用新的域名:doc.thinkphp.cn,并支持版本切换。
现在开始,你可以使用官方提供的ThinkChat,让你在学习ThinkPHP的旅途中享受私人AI助理服务!
Nothing published for this version
改进版本号获取指令 修正异常页面编码输出
修复PHP错误中止时,日志没有写入、中间件end回调没有执行 修正路由分组合并检测 改进文件缓存锁机制 完善模型字段缓存的子目录问题
修复PHP错误中止时,日志没有写入、中间件end回调没有执行 修正路由分组合并检测 改进文件缓存锁机制 完善模型字段缓存的子目录问题
改进ResourceRegister支持更多路由参数设置 改进资源路由注册类 改进RedirectResponse 改进跨域路由 改进自动options路由 options请求默认支持跨域 修正miss路由 完善session有效期问题
改进ResourceRegister支持更多路由参数设置 改进资源路由注册类 改进RedirectResponse 改进跨域路由 改进自动options路由 options请求默认支持跨域 修正miss路由 完善session有效期问题
兼容PHP8.2 移除基础类中Filesystem申明属性 fix: container绑定参数时可变参数处理 File类增加setExtension方法设置保存文件的实际后缀名 ValidateRule注释调整 Fix: 参数类型为多个时导致的报错 更新orm版本依赖支持3.0
兼容PHP8.2 移除基础类中Filesystem申明属性 fix: container绑定参数时可变参数处理 File类增加setExtension方法设置保存文件的实际后缀名 ValidateRule注释调整 Fix: 参数类型为多个时导致的报错 更新orm版本依赖支持3.0
Nothing published for this version
Nothing published for this version
fix: 生成模型字段缓存的命令行指令在模型目录存在子目录时异常
兼容PHP8.2 调整url build方法 支持使用ThinkORM 3.0版本 修正session有效期问题
兼容PHP8.2 调整url build方法 支持使用ThinkORM 3.0版本 修正session有效期问题
- 删除废弃方法 - 优化多语言检测 - 修正命令行模式下的默认request
Fix switchLangSet missing setLangSet
改进缓存驱动unserialize方法参数类型限制 优化代码使IDE友好 修正命令行对8.1的兼容性 路由增加闭包检测有效性
改进缓存驱动unserialize方法参数类型限制 优化代码使IDE友好 修正命令行对8.1的兼容性 路由增加闭包检测有效性
Nothing published for this version
调整thinkPath路径赋值为真实绝对路径 以避免特殊环境潜在隐患
PHP8.1cookie跨域删除url生成Filesystem增加url方法 获取文件访问地址make:controller 指令错误cookie前先检查请求头是否已发送hashName冲突问题thinkPath路径赋值为真实绝对路径 以避免特殊环境潜在隐患env文件解析本版本主要添加了事件监听的通配符支持,并修正了框架的一处可能的序列化漏洞,同时对模型做了一些改进和优化。
本版本主要添加了事件监听的通配符支持,并修正了框架的一处可能的序列化漏洞,同时对模型做了一些改进和优化。
league/flysystem版本Request类all方法增加LogRecord事件 改进File驱动 消除Validate类某处类型声明警告 路由分组增加dispatcher方法 设置分组的调度 request类增加all方法支持获取file在内的所有参数 改进环境变量定义支持多env文件读取
增加LogRecord事件 改进File驱动 消除Validate类某处类型声明警告 路由分组增加dispatcher方法 设置分组的调度 request类增加all方法支持获取file在内的所有参数 改进环境变量定义支持多env文件读取
修正Validate类的PHP8兼容性 改进redis驱动的append方法 优化路由匹配的路由变量正则规则生成 修正路由匹配检测 改进responseView的内容渲染
修正Validate类的PHP8兼容性 改进redis驱动的append方法 优化路由匹配的路由变量正则规则生成 修正路由匹配检测 改进responseView的内容渲染
兼容composer2 生成配置文件 优化optimize:schema指令 增加socket-log 的 curl 超时设置 修正路由匹配 兼容PHP8处理 增加汉字识别匹配范围 支持部分生僻字正则 改进响应文件请求时的缓冲清除 资源路由支持设置变量规则 $request->ip() 方法兼容PH
兼容composer2 生成配置文件 优化optimize:schema指令 增加socket-log 的 curl 超时设置 修正路由匹配 兼容PHP8处理 增加汉字识别匹配范围 支持部分生僻字正则 改进响应文件请求时的缓冲清除 资源路由支持设置变量规则 $request->ip() 方法兼容PHP8 修复验证器in方法,between方法,使用数组,功能异常 修正含有__make的类实例化后未执行invokeAfter的问题 修复命令行创建中间件命名空间无效 bug
兼容Composer 2.0 修正验证类append方法 改进缓存标签机制 改进闭包路由内使用request对象 改进文件缓存驱动
兼容Composer 2.0 修正验证类append方法 改进缓存标签机制 改进闭包路由内使用request对象 改进文件缓存驱动
修复规则为空时 会报错:"未定义变量: result" 的bug 优化session 文件缓存 path 获取 改进路由参数检测 改进路由参数获取和变量检查 修正请求缓存中间件 路由的请求缓存可以通过request_cache_key配置参数关闭 便于开发模式 增加app.url配置 用于命令行下构
修复规则为空时 会报错:"未定义变量: result" 的bug 优化session 文件缓存 path 获取 改进路由参数检测 改进路由参数获取和变量检查 修正请求缓存中间件 路由的请求缓存可以通过request_cache_key配置参数关闭 便于开发模式 增加app.url配置 用于命令行下构建request 调整路由配置载入位置 改进资源路由 修正重定向路由的传参 调整http初始化位置 防止容器绑定自身造成死循环 改进路由缓存指令 取消opis/closure依赖 改进路由的额外参数检测 改进Config类的has方法判断 改进参数绑定 改进验证的append方法处理造成多次验证的情况 改进Redis驱动 多语言支持解析json文件
本次更新包含一个调试模式的系统信息安全隐患修正,建议更新。 ## 主要更新: * 异常提取session数据时先判断是否使用了session * 修正文件上传类 * 取消Event类withEvent方法 * FileResponse支持是否强制下载设置 * Request对象支持ArrayAcce
本次更新包含一个调试模式的系统信息安全隐患修正,建议更新。
session数据时先判断是否使用了sessionEvent类withEvent方法FileResponse支持是否强制下载设置Request对象支持ArrayAccess接口Validate 场景执行优先级getDefaultRootPath方法param参数的BUGpublic_pathFileResponse增加是否强制下载文件选项OPTIONS请求Request->port 的返回类型转化optimize:schema指令header方式自动侦测多语言本次更新包含一个可能的Session安全隐患修正,建议更新。 ## 主要更新: * 改进设置方法后缀后的操作名获取问题 * 修正optimize:schema指令 * 修正Request类inputData处理 * 改进中间件方法支持多个参数 * 修正sessionid检查的一处隐患 * 完善对15
本次更新包含一个可能的Session安全隐患修正,建议更新。
optimize:schema指令inputData处理sessionid检查的一处隐患MongoDb的事务支持(mongodb版本V4.0+)insertAll的replace支持缓存默认的序列化方法改为serialize/unserialize
主要更新:
Request::withInputinvokeMethod方法Socket驱动gzcompress问题expand_level 选项异常remember方法对依赖注入的支持column方法的查询缓存问题getAutoInc方法suffix 和 connection参数column方法的查询官方历时一年多倾力打造的ThinkPHP6.0版本正式发布,该版本基于精简核心和统一用法两大原则在5.1的基础上对底层架构做了进一步的优化改进,并更加规范化。
官方历时一年多倾力打造的ThinkPHP6.0版本正式发布,该版本基于精简核心和统一用法两大原则在5.1的基础上对底层架构做了进一步的优化改进,并更加规范化。
由于引入了一些新特性,ThinkPHP6.0运行环境要求PHP7.1+(推荐PHP7.3+),不支持5.1的无缝升级(官方提供了升级指导)。
PHP7强类型(严格模式)PSR规范ORM组件独立Filesystem组件Swoole以及协程支持改进在主流框架里面,ThinkPHP6.0是最先采用PHP7严格模式的。所有的核心文件都是开启了严格模式的类型约束,因此有任何的变量类型不符的情况都会抛出异常,有利于规范代码中的变量类型和提前发现问题隐患。
新版框架提供了多应用模式支持,默认安装为单应用,你只需要安装一个多应用模式扩展就可以更轻松的部署多个应用而不需要重复安装依赖组件,每个应用都支持独立入口访问以及域名绑定,也可以使用一个入口文件实现自动多应用部署。并且自动多应用模式支持智能识别,对于不存在的应用访问会自动切换到单应用模式进行匹配。同时支持应用的映射和禁止访问机制。
多应用模式的设计可以让开发更加模块化,因为每个应用的配置、路由及视图都可以纳入应用目录,所以更方便应用的模块化,甚至引入composer应用。
新版的容器支持PSR-11规范,容器类的功能特性主要包括:
ArrayAccess支持新版的事件系统可以看成是5.1版本行为系统的升级版,事件系统相比行为系统强大的地方在于事件本身可以是一个类,并且可以更好的支持事件订阅者。支持事件智能订阅,通过反射机制来识别当前订阅者要订阅的事件。
事件相比较中间件的优势是事件比中间件更加精准定位(或者说粒度更细),并且更适合一些业务场景的扩展。例如,我们通常会遇到用户注册或者登录后需要做一系列操作,通过事件系统可以做到不侵入原有代码完成登录的操作扩展,降低系统的耦合性的同时,也降低了BUG的可能性。
中间件分为全局中间件、应用中间件、路由中间件和控制器中间件,这四个中间件分组完全独立执行,但同一个分组内的中间件不会重复执行。中间件方法执行依赖注入,以及请求结束的回调机制。
核心很多功能都是基于中间件来完成,包括多应用模式也是采用中间件机制执行。
新版的路由精简了很多不必要的功能,路由定义也更加规范化和语义化,并且路由定义文件支持纳入应用目录,便于模块化开发。路由注解功能独立为think-annotation库,并且使用更加规范,支持IDE提示。
新版的请求对象更易扩展,系统默认安装后提供了一个app\Request类,你可以在应用中直接自定义请求对象,增加必要的属性和方法。但不会影响对think\Request的依赖注入和门面调用。
由于核心框架采用了服务化设计,你可以在你的扩展或者应用中注册需要的服务。在系统服务中注册一个对象到容器,或者对某些对象进行相关的依赖注入。由于系统服务的执行优先级问题,可以确保相关组件在执行的时候已经完成相关依赖注入。一个服务类通常包括注册(register)和启动(boot)方法,用于不同阶段的执行。
内置的ORM功能已经完全独立为think-orm组件,可以独立使用,ThinkPHP6.0默认依赖安装了该组件,保持用法不变的同时,增强了查询功能。
核心不再内置任何模板引擎,仅提供PHP模板支持,官方的模板引擎已经独立为think-template模板引擎,并默认依赖安装。你可以更方便的使用第三方模板引擎。
日志支持多通道、并统一命令行和WEB日志格式,主要包括:
6.0版本的Session机制完全重写了,并且不再使用PHP内置的Session机制,全新实现一套Session机制,可以更好的支持Swoole/Workerman等环境。
所以不再支持PHP内置的session_*** 系列函数,也不再支持使用$_SESSION读取session数据,你必须通过框架提供的Session类或者门面来操作,Request类也封装了Session数据的读取。
Session支持跨应用读取和自定义序列化机制,默认采用文件类型记录Session数据,由于共用了缓存机制,你还可以使用任何支持的缓存类型来记录Session数据。
新版增加了Filesystem类库对文件系统强化了支持,而且可以很方便的支持各种云存储,包括阿里云和七牛云。
Swoole扩展同时支持HTTP和Socket服务,支持数据库和缓存的连接池功能,以及RPC功能。
原来内置的页面Trace调试工具已经更改为扩展的方式,改成安装think-trace扩展,如果通过composer安装应用的话,默认会安装topthink/think-trace扩展。
基本用法和之前保持不变,但无需额外配置,默认使用html方式显示,同时仍然支持浏览器控制台显示,并仅在调试模式下有效。
同时增加了一个基于debugbar的调试扩展think-debugbar,需要单独安装后才能使用。
composer require topthink/think-debugbar
新版对很多用法进行了精简和统一,尽可能避免在开发过程中规范不一的困惑。
更多内容可以查看官方的完全开发手册。
鉴于多应用模式的复杂性和扩展性考虑,最新版本把多应用模式独立为框架的一个全局中间件扩展。默认安装后核心框架为单应用模式,如果需要使用多应用模式,可以安装 ` composer require topthink/think-multi-app `
主要更新包括:
鉴于多应用模式的复杂性和扩展性考虑,最新版本把多应用模式独立为框架的一个全局中间件扩展。默认安装后核心框架为单应用模式,如果需要使用多应用模式,可以安装
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
RC4版本主要改进包括ORM库独立,日志系统增加多通道支持,缓存、日志、数据库的配置文件统一调整为多通道模式。
RC4版本主要改进包括ORM库独立,日志系统增加多通道支持,缓存、日志、数据库的配置文件统一调整为多通道模式。
本次更新相对于RC3版本主要涉及配置文件的更新,其它调整参考更新日志的用法调整部分。
think-orm库数据库和模型操作核心不再内置,改为统一依赖topthink/think-orm库(该类库已经包括其它的数据库驱动),用法保持一致,功能也没有任何的缺失。
此前think-orm库已经独立更新维护,但一直是同步核心的ORM,2.0版本进行了架构调整,保持独立性的同时支持框架依赖,以后数据库操作这块统一在此类库更新。
对模型做了大量的功能改进,主要包括:
withField和withLimit方法hasWhere方法对闭包查询条件的支持完善has/hasWhere的多次调用has/hasWhere方法支持软删除has/hasWhere查询此次更新对日志类做了较大的调整和增强,主要包括:
Filesystem组件Filesystem组件用以替代之前的上传类,提供了更多上传到远端的扩展库支持。
容器中的对象实例化之后,引入回调机制,利用该机制可以实现诸如注解功能等相关功能。
你可以通过resolving方法注册一个全局回调
Container::getInstance()->resolving(function($instance,$container) {
// ...
});
回调方法支持两个参数,第一个参数是容器对象实例,第二个参数是容器实例本身。
或者单独注册一个某个容器对象的回调
Container::getInstance()->resolving(\think\Cache::class,function($instance,$container) {
// ...
});
think-annotation库路由注解功能独立为think-annotation库,并且使用更加规范,支持IDE提示。
在多应用模式下,路由定义文件支持放入应用目录的route目录下。
view目录模板根目录默认从应用目录下移动到根目录的view目录,如果是多应用模式的话,下面是应用子目录,如果你需要改回放入原先的应用目录下,可以在应用的template配置文件中定义view_path。
'view_path' => app_path('view'),
parseLike查询ViewResponse类增加内容渲染输出支持display助手函数maker方法支持注入扩展验证规则Console/Table类withField和withLimit方法,并取消Query类withField方法withLimit的支持toArray方法make:command指令生成DateInterval json查询filesystem组件options请求类型hasWhere方法对闭包查询条件的支持完善time_query_rule数据库配置参数 用于自定义时间查询规则redis驱动invoke回调机制withModel和withValidate 对各个路由设置不同的模型绑定和验证getLastInsID方法paginateX查询用于大数据分页查询first和last方法response/View类的assign方法pathinfo方法__call方法Trace机制validate助手函数,支持设置验证失败后是否抛出异常bind方法RedirectResponsethink optimize:schema 指令isPjax判断subDomain方法input助手函数refresh方法root方法MorphTo关联insert方法connect方法allowCrossDomain方法chunk方法checkSizesetRule方法whereTime查询request助手函数switch更改为suffixfetchArray方法select查询方法默认返回数据集对象optimize:config指令init和connect方法取消 并入store方法cache助手函数取消初始化用法cache助手函数留空返回Cache对象timestamptopthink/think-annotationurl_convert配置参数route:build指令viewfind查询必须使用查询条件service配置文件默认放到vendor目录下LogLevel事件user配置改为通过静态方法设置当前执行用户RC3版本主要改进和优化了系统内置中间件,改进了一些用法和体验,并且把不常用的驱动移出核心改为扩展方式提供。
RC3版本主要改进和优化了系统内置中间件,改进了一些用法和体验,并且把不常用的驱动移出核心改为扩展方式提供。
whereWeek日期查询// 查询本周文章
Article::whereWeek('create_time')->select();
// 查询上周文章
Article::whereWeek('create_time', 'last week')->select();
// 查询2019-1-1到2019-1-7的文章
Article::whereWeek('create_time', '2019-1-1')->select();
自增ID获取的时候会根据主键的字段类型自动转换处理,而不是PDO默认返回的字符串类型。
记录当前请求的路由规则对象,可以通过
$request->rule();
获取当前请求实际匹配的路由规则对象
requireWithout验证规则表示当某个字段没有数据的时候必须,可以组合完成表单中某两个字段必须填写一项的验证,例如:
'phone' => 'requireWithout:mobile',
'mobile'=> 'requireWithout:phone',
优化路由ext和name方法以及URL生成
取消了内置的think\Controller控制器基类,在项目中提供了app\BaseController控制器基类更方便自定义。
另外项目还提供了app\Request自定义请求类,可以自定义应用所需的请求方法和属性。提供了app\ExceptionHandle自定义异常处理类
,方便对异常进行自定义接管处理。
Route类buildUrl及url助手函数返回类型改为think\route\Url对象实例而不是字符串,由于定义了__toString方法,因此可以在模板中直接输出为URL字符串。
echo url('index/hello',['name'=>'think'])->suffix('htm')->domain('blog');
改进修改器方法支持不返回任何数据,而是在修改器中直接设置数据
例如:
class User extends \think\Model
{
public function setField1Attr($value,$data){
$this->set('field2', $data['field2']);
$this->set('field3', $data['field3']);
}
}
$user = new User;
$user->field1 = 'value1';
$user->save();
实际写入数据库的时候不会包含field1字段数据,但会包含field2和field3的数据。
dump/halt助手函数调整支持输出多个变量你可以使用
dump($var1,$var2,...)
方式输出多个变量调试,同样halt方法也可以支持调试多个变量输出并中止执行。
最新版本会在安装项目的时候安装symfony/var-dumper扩展替换内置的dump助手函数,因此你可以进行更强大的输出
关联together方法自动更新和删除的时候可以无需使用with
例如,之前的写法
$article = Article::with('comments')->find(1);
$article->together(['comments'])->delete();
现在可以直接写成
$article = Article::find(1);
$article->together(['comments'])->delete();
delete和update方法可以批量对数据集进行更新和删除操作(支持模型事件)
// 更新今天的数据
$list = Article::whereDay('create_time')->select();
$list->update(['is_new'=>1]);
// 删除昨天的数据
$list = Article::whereDay('create_time', 'yesterday')->select();
$list->delete();
<?php
namespace app\model;
use think\Model;
class Blog extends Model
{
// 定义默认的表后缀(默认查询中文数据)
protected $suffix = _cn';
}
模型提供了动态切换方法switch和setSuffix,例如:
// switch方法用于静态查询
Blog::switch('_en')->find();
// setSuffix用于动态设置
$blog = new Blog($data);
$blog->setSuffix('_en')->save();
在注解中定义路由分组,可以使用
<?php
namespace app\controller;
/**
* @group('blog')
*/
class Blog
{
/**
* @param string $name 数据名称
* @return mixed
* @route('hello/:name','get')
*/
public function hello($name)
{
return 'hello,'.$name;
}
}
当前控制器中的注解路由会自动加入blog分组下面,最终,会注册一个blog/hello/:name的路由规则。你一样可以对该路由分组设置公共的参数,例如:
<?php
namespace app\controller;
/**
* @group('blog')->ext('html')
* ->pattern(['id' => '\d+', 'name' => '\w+'])
*
*/
class Blog
{
/**
* @param string $name 数据名称
* @return mixed
* @route('hello/:name','get')
*/
public function hello($name)
{
return 'hello,'.$name;
}
}
如果你已经在路由定义文件中定义了blog分组,也可以直接把某个路由加入该分组,例如:
<?php
namespace app\controller;
class Blog
{
/**
* @param string $name 数据名称
* @return mixed
* @route('hello/:name','get')->group('blog')
*/
public function hello($name)
{
return 'hello,'.$name;
}
}
你可以在定义多语言的时候使用分组定义
return [
'user' => [
'welcome' => '欢迎回来',
'login' => '用户登录',
'logout' => '用户登出',
]
];
然后使用下面的方式获取多语言变量
Lang::get('user.login');
lang('user.login');
可以通过extend_list设置,例如:
'extend_list' => [
'zh-cn' => [
app()->getBasePath() . 'lang\zh-cn\app.php',
app()->getBasePath() . 'lang\zh-cn\core.php',
],
]
便于在扩展中自定义语言包
,并且现在已经支持语言文件使用YML格式定义
增加TagSet类,tag方法支持传入数组,同时对多个标签进行操作
Cache::tag('tag')->set('name1','value1');
Cache::tag('tag')->set('name2','value2');
// 清除tag标签的缓存数据
Cache::tag('tag')->clear();
并支持同时指定多个缓存标签操作
Cache::tag(['tag1', 'tag2'])->set('name1', 'value1');
Cache::tag(['tag1', 'tag2'])->set('name2', 'value2');
// 清除多个标签的缓存数据
Cache::tag(['tag1','tag2'])->clear();
可以追加某个缓存到标签
Cache::tag('tag')->append('name3');
push方法增加元素到一个数组缓存
Cache::set('name', [1,2,3]);
Cache::push('name', 4);
Cache::get('name'); // [1,2,3,4]
deny_app_list配置参数可以配置禁止直接访问的应用列表
控制器中间件的only和except定义不区分大小写
app_map支持指定泛应用映射可以在app_map配置中定义泛应用解析到指定应用,例如:
'app_map' => [
'think' => 'admin', // 把admin应用映射为think
// ... 其它应用映射定义
'*' => 'home', // 其它应用解析到home
],
RedirectResponse flush方法make:controller指令生成get方法默认值dateFormat属性方法update操作Relation::$selfRelation默认为null,导致Relation::isSelfRelation()方法报错redis缓存驱动observe方法getNamespaces方法where查询方法传入Query对象的时候缺少bind数据的问题method方法route:list指令Collection类load方法redis驱动的端口类型session数据序列化使用JSON处理的问题hidden方法隐藏关联模型的问题Request类has方法对env和session的支持provider.php文件无效问题getValidateType方法trace中间件仅在调试模式有效
,并且无需设置环境变量Socket日志驱动移出核心PostgreSQL、Sqlite和SqlServer驱动移出核心
,改为扩展think\Controller基类Yaconf支持移出核心 纳入扩展think-yaconf withoutField方法useGlobalScope方法增加withoutGlobalScope方法Cookie类恢复get和has方法支持token助手函数调整:分割传参auto_detect配置session类的auto_start配置参数和boot方法Where数组对象查询JumpResponse及success/error/result等方法和助手函数think\db\Expression类cookie的prefix参数optimize:facade optimize:model指令 改为扩展方式Config类__get 和 __isset 方法部分核心功能中间件化(页面Trace、多语言、请求缓存和Session初始化)
主要更新如下:
HttpSession类重构,不再使用PHP内置会话Cookie类仅支持设置和写入,不再支持读取Config类的动态设置功能View类改为内置,但默认仅支持原生PHP模板Nothing published for this version
Nothing published for this version
改进redis驱动has方法 修正XA事务 修正HasManyThrough关联 增加mysql json类型字段->>方式获取支持 改进路由加载 避免加载编辑器临时文件影响 修复关联模型的属性直接附加到当前模型,当关联模型字段名为name时获取的值为模型的属性name值 修复多态关联预加载fiel
改进redis驱动has方法 修正XA事务 修正HasManyThrough关联 增加mysql json类型字段->>方式获取支持 改进路由加载 避免加载编辑器临时文件影响 修复关联模型的属性直接附加到当前模型,当关联模型字段名为name时获取的值为模型的属性name值 修复多态关联预加载field无效 改进Collection类的column方法的PHP兼容性问题 改进mysql驱动 改进parseclosure方法 SoftDelete删除条件做空判断 改进验证类append方法
修复使用Cache::clear()时,报错缓存文件不存在问题
本次更新为常规更新,主要包括:
memcached驱动HasManyThrough关联查询Request类isJson方法redis驱动getWhere方法对复合主键的支持newQuery方法ValidateCache::clear()时,报错缓存文件不存在问题paraseData方法改进Controller类display/fetch方法返回ViewResponse对象
Request类增加isJson方法has/hasWhere查询parseIn解析parseLike查询toArray方法notIn查询JSON字段查询display/fetch方法返回ViewResponse对象param方法mysql驱动getExplain方法has/hasWhere方法对软删除的支持- 改进关联数据更新 - 修正关联动态获取器 - 改进redis驱动 - 修复validate规则里面出现二维数组时的错误 - 改进跨域请求 - 完善模型hidden方法对关联属性的支持 - 改进where查询方法传入Query对象的支持bind数据 - 改进数据集对象的load方法 - 修正缓存c
HasMany关联类saveAll方法兼容Collection格式参数格式
本次更新为常规更新,主要更新如下:
chunk方法一处异常抛出的错误visiblelevel配置支持saveAll方法兼容Collection格式参数格式whereOr查询使用字符串的问题dateFormat设置对写入数据的影响- 修正验证类自定义验证方法执行两次的问题 - 模型增加isEmpty方法用于判断是否空模型 - 改进获取器对append的支持 - 修正一对多关联的withCount自关联问题 - facade类注释调整 - 改进关联属性的visible - 改进toarray的hidden判断 - 修正路由分组
- 改进Request类的has方法,支持patch - 改进unique验证的多条件支持 - 修复自定义上传验证,检测文件大小 - 改进in查询支持表达式 - 改进路由的getBind方法 - 改进验证类的错误信息获取 - 改进response助手函数默认值 - 修正mysql的regexp查询
- 修复路由中存在多个相同替换的正则BUG - 修正whereLike查询 - join方法支持参数绑定 - 改进union方法 - 修正多对多关联的attach方法 - 改进验证类的正则规则自定义 - 改进Request类method方法 - 改进File日志类型的CLI日志写入 - 改进文件日志
本次主要为常规更新,修正了一些反馈的问题。 主要更新日志: * 改进多对多关联的attach方法 * 改进聚合查询的field处理 * 改进关联的save方法 * 修正模型exists方法返回值 * 改进时间字段写入和输出 * 改进控制器中间件的调用 * 改进路由变量替换的性能 * 改进缓存标签的处
本次主要为常规更新,修正了一些反馈的问题。
主要更新日志:
attach方法field处理save方法exists方法返回值统一助手函数与\think\response\Download函数文件过期时间
本次版本包含一个安全更新,建议升级。
field方法count方法返回类型download函数增加在浏览器中显示文件功能sqlsrv驱动支持多个Schemas模式查询save方法 增加make方法仅创建对象不保存field解析修复 array_walk_recursive 在低于PHP7.1消耗内部指针问题
该版本为常规更新,修正了一些社区反馈的问题。
主要更新如下:
execute方法orderRaw异常optimize:autoload指令destroy方法造成重复执行事件的问题requireremove所有规则的异常Connection类的getrealsql方法https地址的URL生成array_walk_recursive 在低于PHP7.1消耗内部指针问题field参数支持Expression该版本主要改进了参数绑定的解析问题和提高性能,并修正了一些反馈的问题。
该版本主要改进了参数绑定的解析问题和提高性能,并修正了一些反馈的问题。
belongsto关联的has方法hasMany关联query类的默认查询参数处理parseBetween解析方法Env类的getEnv和get方法remove规则异常strpos对子串是否存在的判断choice无法用值选择第一个选项问题extend和block标签的正则该版本主要修正了上一个版本存在的一些问题,并改进了关联查询部分。
该版本主要修正了上一个版本存在的一些问题,并改进了关联查询部分。
DISTINCTurl函数的端口支持swoole的支持save方法get方法fetchsql的情况afterWith和beforeWith验证规则 用于比较日期字段该版本主要修正了路由绑定的参数,改进了修改器的执行多次问题,并正式宣布为LTS版本!
该版本主要修正了路由绑定的参数,改进了修改器的执行多次问题,并正式宣布为LTS版本!
主要更新:
该版本主要修正了上一个版本的一些问题,并改进了全局查询范围的支持,同时包含了一个安全更新。
该版本主要修正了上一个版本的一些问题,并改进了全局查询范围的支持,同时包含了一个安全更新。
主要包括:
globalScope属性定义 用于指定全局的查询范围useGlobalScope方法支持传入数组 用于指定当前查询需要使用的全局查询范围order方法对数字类型的支持order方法解析的一处BUGRequest类的file方法对上传文件的错误判断该版本主要改进了查询参数绑定的性能和对浮点型的支持,以及一些细节的完善。
该版本主要改进了查询参数绑定的性能和对浮点型的支持,以及一些细节的完善。
Socketlog日志驱动,支持自定义默认展开日志类别MorphMany一处bugorder方法解析json字段数据的自动编码log_write可能造成的日志写入死循环log_level行为标签位置,用于对某个类型的日志进行处理clear方法清空路由规则max_files参数only和except定义不区分大小写该版本主要增加了命令行的表格输出功能,并增加了查看路由定义的指令,以及修正了社区的一些反馈问题。
该版本主要增加了命令行的表格输出功能,并增加了查看路由定义的指令,以及修正了社区的一些反馈问题。
Request类的file方法cache方法fetchCollection方法支持传入数据集类名Middleware类clear方法route:list指令用于查看定义的路由 并支持排序Table输出类Command类增加table方法用于输出表格auto_path参数用于定义自动载入的命令类路径make:command指令用于快速生成指令make:controller指令对操作方法后缀的支持value和column方法对后续查询结果的影响RuleName类的setRule方法该版本主要改进了数据集对象的处理和Yaconf的支持,增加了findOrEmpty方法,并且修正了一些社区反馈的BUG。
该版本主要改进了数据集对象的处理和Yaconf的支持,增加了findOrEmpty方法,并且修正了一些社区反馈的BUG。
diff/intersect方法用于获取差集和交集(默认根据主键值比较)order方法支持指定字段排序map方法使用回调函数处理数据并返回新的数据集对象allowEmpty方法允许find方法在没有数据的时候返回空数组或者空模型对象而不是nullfindOrEmpty方法fetchCollection方法用于指定查询返回数据集对象order方法的数组方式解析,增强安全性withSearch方法,支持第三个参数传入字段前缀标识,用于多表查询字段搜索optimize:route指令开启类库后缀后的注解路由生成Yaconf的独立配置文件yaconf助手函数用于配置文件该版本主要增加了模型搜索器和withJoin方法,完善了模型输出和对Yaconf的支持,修正了一些社区反馈的BUG。
该版本主要增加了模型搜索器和withJoin方法,完善了模型输出和对Yaconf的支持,修正了一些社区反馈的BUG。
table识别问题Facade类withJoin方法支持join方式的一对一关联查询join预载入查询的空数据问题Config类的load方法支持快速加载配置文件execute方法和事务的断线重连memcache驱动的has方法Config类对Yaconf的支持hidden/visible/append/withAttr方法,支持在查询前后调用,以及支持数据集对象where方法根据字段或者关联数据过滤数据204判断该版本主要增加了下载响应对象和数组查询对象的支持,并修正了一些社区反馈的问题。
该版本主要增加了下载响应对象和数组查询对象的支持,并修正了一些社区反馈的问题。
isRelationAttr方法判断get和all方法并入Db类download助手函数resultToModel方法Response类增加noCache快捷方法Swoole/Workerman下面参数多次合并问题ajax/pjax参数后路由变量无法正确获取的问题hasWhere的数组条件的字段判断Where查询支持(喜欢数组查询的福音)One column per quarter.