# 版本更新日志 [TOC=2,2] ## `V6.0.12LTS`（2022年1月21日） 本版本主要完善了命令行对`PHP8.1`的支持，并增加了路由的闭包检测机制。 ### 主要更新 * 改进缓存驱动`unserialize`方法参数类型限制 * 优化代码使IDE友好 * 修正命令行对`PHP8.1`的兼容性 * 路由增加闭包检测有效性 ### `ThinkORM`主要更新包括： * 完善sqlite驱动 * 修正Fetch类 * 改进多对多关联 * 添加数据写入对对象值的判断处理 * 改进一对一关联写入 * 一对一关联查询绑定属性调整 * 改进远程一对多关联查询 * 优化模型数据处理 ## `V6.0.11LTS`（2022年1月日5） * 修正ENV读取问题 ## `V6.0.10LTS`（2021年12月31日） 本版本主要添加了`PHP8.1`的兼容支持，以及`ThinkORM`的大量改进。 ### 主要更新： * 兼容PHP8.1 * 改进cookie跨域删除 * 改进多语言自动加载 * 改进url生成 * Filesystem 增加url方法 获取文件访问地址 * 文件上传错误支持多语言 * 修正 make:controller 指令错误 * 发送cookie前先检查请求头是否已发送 * 改进多文件上传的文件hashName冲突问题 * 调整thinkPath路径赋值为真实绝对路径 以避免特殊环境潜在隐患 * 支持 psr7 response * 控制器中间件支持动态参数 * 改进env文件解析 ### `ThinkORM`主要更新包括： * 修正column方法 * Db和模型增加filter数据处理机制 * 调整json处理 * 修正sqlite驱动lock * 获取数据库字段类型不区分大小写 * 修正json方法 * 修正多对多关联中间表数据 * 修正多对多模型 * 改进db类hidden visible append 方法处理机制 * 改进关联的软删除查询 * 完善获取sql时的字符转义 ## `V6.0.9`（2021年07月22日） 本版本主要添加了事件监听的通配符支持，并修正了框架的一处可能的序列化漏洞，同时对模型做了一些改进和优化。 * 更新`league/flysystem`版本 * 事件监听支持通配符 * 支持时间字段的统一配置 * 改进`Request`类`all`方法 >[danger] 由于`league/flysystem`低版本存在漏洞，官方进行了安全升级，该修正使得框架的PHP版本依赖也提升到`7.2+`。 `ThinkORM`主要更新如下： * 强化虚拟模型支持 * 改进模型事件和数据库事件 * 改进动态获取器处理 * 优化分页查询 * 改进聚合查询 * 关联增加`withoutField`方法 * 软删除`destroy`方法优化 ## `V6.0.8`（2021年04月26日） 本版本主要添加了多环境变量配置文件支持 * 增加`LogRecord`事件 * 消除`Validate`类某处类型声明警告 * 路由分组增加`dispatcher`方法，支持设置分组的调度 * `Request`类增加`all`方法支持获取包括`File`在内的所有参数 * 改进环境变量定义支持多`env`文件读取 ## `V6.0.7`（2021年01月25日） 本版本主要针对上个版本做了一些路由修正，还意外收获了一些性能提升，是一个建议更新的版本。 * 修正`Validate`类的PHP8兼容性 * 改进`redis`驱动的`append`方法 * 修正路由匹配检测问题 * 优化路由变量正则规则生成 * 改进`responseView`的内容渲染 ## `V6.0.6`（2021年01月11日） 本版本更新为兼容PHP8.0版本，并做了一些的改进和优化。 * 兼容`composer2 `生成配置文件 * 优化`optimize:schema`指令 * 增加`socket-log` 的 curl 超时设置 * 修正路由匹配 * 增加兼容`PHP8`处理 * 增加汉字识别匹配范围 支持部分生僻字正则 * 改进响应文件请求时的缓冲清除 * 资源路由支持设置变量规则 * `$request->ip()` 方法兼容PHP8 * 修复验证器`in`、`between`方法,使用数组,功能异常 * 修正含有`__make`的类实例化后未执行`invokeAfter`的问题 * 修复命令行创建中间件命名空间无效 bug ## `V6.0.5`（2020年10月27日） 本次更新为兼容Composer2.0做的特别更新版本，主要包含： * 修正验证类append方法 * 改进缓存标签机制 * 改进闭包路由内使用request对象 * 改进文件缓存驱动 ## `V6.0.4`（2020年9月28日） 本次更新为常规更新，主要包含： ### 新增 * [新增] 多语言支持解析`json`文件 * [新增] 增加`app.url`配置 用于命令行下构建`request ` * [新增] 模型类增加`convertNameToCamel`属性，支持数据格式转为驼峰命名输出 * [新增] `Relation`类增加`getForeignKey`和`getLocalKey`方法 ### 修正 * [修正] 修复规则为空的bug * [修正] 修正请求缓存中间件 * [修正] 改进验证的`append`方法处理造成多次验证的情况 * [修正] 改进资源路由对路由到类的支持 * [修正] 修正重定向路由的传参 * [修正] 调整`http`初始化位置 防止容器绑定自身造成死循环 * [修正] 改进Redis驱动`select`参数处理 * [修正] 改进多对多关联查询 ### 优化 * [优化] 优化`session `文件缓存 `path `获取 * [优化] 改进路由参数检测 * [优化] 改进路由参数获取和变量检查 * [优化] 路由的请求缓存可以通过`request_cache_key`配置参数关闭 便于开发模式 * [优化] 调整路由配置载入位置 * [优化] 改进路由缓存指令 取消`opis/closure`依赖 * [优化] 改进路由的额外参数检测 * [优化] 改进`Config`类的`has`方法判断 * [优化] 改进参数绑定对Null值的支持 * [优化] 改进`when`条件查询的闭包处理 * [优化] 改进一对一关联查询对`order`排序的支持 ## `V6.0.3`（2020年6月25日） 本次更新包含一个调试模式的系统信息安全隐患修正，建议更新。 ### 主要更新： * 异常提取`session`数据时先判断是否使用了`session` * 修正文件上传类 * 取消`Event`类`withEvent`方法 * `FileResponse`支持是否强制下载设置 * `Request`对象支持`ArrayAccess`接口 * 日志的时间记录增加微秒数据支持 * 调整 `Validate `场景执行优先级 * 优化App类`getDefaultRootPath`方法 * 修正全局中间件获取`param`参数的BUG * clear命令支持多层级目录 * 修正日志记录时区问题 * 修复助手函数`public_path` * 中间件支持多个参数 * 路由检测严格按照路由定义的顺序执行 * `FileResponse`增加是否强制下载文件选项 * 修复自定义命令别名比系统别名长导致报错问题 * 改进路由到视图的变量传递 * 允许路由到一个自定义调度类 * 完善路由单元测试 * 默认路由也支持自动`OPTIONS`请求 * 改进路由调度 * 改进host和port的获取支持代理 * `Request->port` 的返回类型转化 * 改进模型生成模板 * 简化默认异常页面信息显示 * 数据库支持设置缓存store * 改进`optimize:schema`指令 * 为清理指令添加仅删除过期文件的选项 * 请求缓存增加预检缓存配置 默认有效期1800秒 * 支持`header`方式自动侦测多语言 ## `V6.0.2`（2020年1月13日） 本次更新包含一个可能的`Session`安全隐患修正，建议更新。 ### 主要更新： * 改进设置方法后缀后的操作名获取问题 * 修正`optimize:schema`指令 * 修正`Request`类`inputData`处理 * 改进中间件方法支持传多个参数 * 修正`sessionid`检查的一处隐患 * 完善对15位身份证号码的校验 * 增加远程多对多关联支持 * 增加`MongoDb`的事务支持（`mongodb`版本V4.0+） * 改进`insertAll`的`replace`支持 ## `V6.0.1`（2019年12月24日） ### 主要更新： * 完善`Request::withInput ` * 修正Content-Type获取途径 * 改进 SocketLog 驱动 * 修正 ClientArg 获取途径 * 修复FileResponse的cookie空对象异常 * 支持渲染完整的异常链信息 * 异常页面支持折叠调用堆栈信息 * 改进异常响应时内容的一致性 * 改进Error控制器对数字访问的支持 * 修正redirect助手函数 * memcached delete 支持 timeout * 修正redis驱动 * 改进memcache驱动 * 改进容器类`invokeMethod`方法 * 使用新的数组语法替代list * 缓存默认的序列化方法改为serialize/unserialize * Add Cookie SameSite(PHP>7.3) * 扩展`Socket`驱动 * 修正异常页面的模板文件 * 事件监听去重 * 取消视图日志 * 修正验证jpg结尾的图片报错问题 * 改进Url生成 * 改进Url生成伪静态后缀设置false的情况 * 改进File类型session读取`gzcompress`问题 * 修复使用路由验证后路由变量丢失的问题 * 修正多应用下路由目录路径 * 修复 `expand_level `选项异常 * 改进Cache类`remember`方法对依赖注入的支持 * 防止因日志配置异常时陷入死循环 * 模型支持动态设置数据库连接 * 修正`column`方法的查询缓存问题 * 改进Query类的`getAutoInc`方法 * 改进模型更新条件获取 * 修正使用模型对象更改数据时忽略自定义的`suffix `和 `connection`参数 * 修正XA事务 * 规范`column`方法的查询 ## `V6.0.0`（2019年10月24日） ### 主要更新日志 * mobile 验证简化 * 控制器中间件支持传参 * 增强中间件CheckRequestCache的实用性 * 改进容器invokeClass方法异常处理 * 控制器中间件过滤条件支持字符串 * 改进Route类getDomainBind方法 * 防止路由标识生成URL时生成空字符串 * 让中间件CheckRequestCache只访问一次临界区 * 完善命中判断 * 修正Request::port返回类型 * 增强高并发下session_id生成的唯一性 * 取消路由缓存功能及相关指令 * 修正 Request::remotePort 返回类型 * 完善跨域中间件的响应头部 * 改进容器异常处理 * 改进生成文件模板 * 移除build指令纳入扩展 * 改进Response增加cookie方法用于设置Cookie * 修正生成URL不传参数时，方法名为空 * 修复中间件CheckRequestCache使用过期数据 * 修复memcache驱动inc函数重复添加前缀问题 * 删除Resonse类setCookie方法 * 使用session_create_id生成id，保证唯一性 * 修复中间件FormTokenCheck无法启用问题 * 修正halt助手函数 ## RC5（2019年10月13日） `RC5`版本主要改进包括多应用模式独立，以及中间件机制调整。 ### 主要新特性 * 多应用模式独立为扩展 * 中间件分组执行 * 增加路由配置文件的全局中间件定义 * 中间件支持优先级定义 * 中间件支持请求结束回调 * 中间件执行去重 * 模板根目录免配置自动识别 * 改进智能事件订阅 * 页面Trace独立为扩展 ### 更新日志 * 修正request类isJson方法 * 提升swoole下多应用的性能 * 修正Cookie保存 * 改进字段缓存指令 * 修正路由正则生成 * 改进模板变量的全局赋值 * 改进filesystem * 改进View 增加单元测试 * 修正php模板驱动 * 取消view_base配置，增加view_dir_name配置 * 完善Session及其单元测试 * 改进session助手函数支持获取所有数据 * 完善中间件及其单元测试 * 改进事件智能订阅 * 验证错误信息支持数组 * 改进多语言自动侦测 * 改进自动多语言 * 改进事件观察者支持事件前缀 * 去除Cache返回类型限制 * 多应用配置读取优先级调整 * 多应用路由改进 * 改进批量验证的错误信息返回 * 页面Trace中间件移除 改为扩展 * 改进session初始化中间件 * 修正默认URL访问 * 修正url生成对域名绑定的支持 * 改进中间件机制 全局、路由和控制器中间件分开 ### 调整 * 获取当前应用名改为`app('http')->getName()` ## RC4（2019年8月16日） `RC4`版本主要改进包括`ORM`库独立，日志系统增加多通道支持，缓存、日志、数据库的配置文件统一调整为多通道模式，并作了大量的改进和修正。 ### 主要新特性 * 数据库和模型改为独立的`think-orm`库 * 模型关联功能增强 * 日志支持多通道、并统一命令行和WEB日志格式 * 增加`Filesystem`组件 * 增加容器对象实例化回调机制 * 路由注解独立为`think-annotation`库 * 多应用模式下路由定义支持纳入应用目录 ### 功能改进 * 改进路由类的配置读取 * 改进`parseLike`查询 * 改进`ViewResponse`类增加内容渲染输出支持 * 增加`display`助手函数 * 验证类`maker`方法支持注入扩展验证规则 * 改进事件触发的对象传入 * 改进`Console/Table`类 * 改进关联定义对查询构造器的支持 * 关联类增加`withField`和`withLimit`方法，并取消`Query`类`withField`方法 * 增加延迟关联查询对`withLimit`的支持 * 改进模型`toArray`方法 * 改进Url生成的域名参数 * 改进 `make:command`指令生成 * 缓存有效期支持`DateInterval ` * 改进Query类find方法 * 改进`json`查询 * 改进查询缓存 * 增加`filesystem`组件 * 改进跨域请求 * 改进路由检测缓存配置 * 改进注解路由的文件写入 * 路由注册支持注册`options`请求类型 * 改进重定向路由检测 * 改进模型的`hasWhere`方法对闭包查询条件的支持完善 * 增加`time_query_rule`数据库配置参数 用于自定义时间查询规则 * 改进时间字段类型的自动识别 * 改进`redis`驱动 * 容器对象增加`invoke`回调机制 * 改进多对多关联 * 资源路由增加`withModel`和`withValidate `对各个路由设置不同的模型绑定和验证 * 改进`getLastInsID`方法 * 日志类调整 支持多通道写入 * 改进模型输出 * 支持单独关闭某个通道的日志写入 * 取消部署模式下 不写入调试日志的功能 用调试级别设置单独的日志渠道来替代 * 改进日志记录格式 * 支持日志输出格式化 * 改进资源路由 * 改进命令行日志实时写入 * 日志通道支持单独设置level配置参数 * Log类调整优化 * 增加`paginateX`查询用于大数据分页查询 * 数据集增加`first`和`last`方法 * 改进`response/View`类的`assign`方法 * 改进请求参数获取问题 * 改进`pathinfo`方法 * 增加一些路径助手函数 * 改进多级控制器访问 * Log类支持`__call`方法 * 多应用模式的路由定义支持放入单独的应用目录 * 模型增加依赖注入支持 * 改进模型事件 * 改进页面`Trace`机制 * 改进`validate`助手函数,支持设置验证失败后是否抛出异常 * 改进容器`bind`方法 * 改进Redis Session驱动 * 改进日志记录的空行问题 * 改进`RedirectResponse ` * 改进缓存驱动 * 改进`think optimize:schema` 指令 * Url类增加https方法 * 改进`isPjax`判断 * 改进Db类配置获取 ### 问题修正 * 修正模型属性获取 * 修正Request类的过滤功能 * 修正`subDomain `方法 * 修正`input`助手函数 * 修正模型`refresh`方法 * 修正关联统计不使用子查询的方式 * 修正Request类`root`方法 * 修正缓存有效期处理 * 修正`MorphTo`关联 * 修正缓存标签 * 修正mysql驱动`insert`方法 * 修正Db类`connect`方法 * 修正`allowCrossDomain`方法 * 修正Query类`chunk`方法 * 修正分组跨域 * 修正关联预载入查询 * 修正时间字段写入 * 修正验证类`checkSize ` * 修正多对多关联闭包 * 修正RuleName类`setRule`方法 * 修正`whereTime`查询 * 修正`request`助手函数 * 修正日志关闭配置 * 修复对多字节字符的兼容性 ### 用法调整 * 模型切换后缀方法`switch`更改为`suffix ` * 取消Query类的`fetchArray`方法 * `select`查询方法默认返回数据集对象 * 取消`optimize:config`指令 * 调整数据库和缓存配置文件格式 默认采用多类型支持 方便切换 * Cache类的`init`和`connect`方法取消 并入`store`方法 * `cache`助手函数调整 * `cache`助手函数取消初始化用法 * `cache`助手函数留空返回Cache对象 * 调整调试模式检测位置 * 默认时间字段类型改为`timestamp ` * 取消Model类`getConnection`和`setConnection`方法 * 注解路由移出核心，注解相关功能使用`topthink/think-annotation ` * 改进路由 取消`url_convert`配置参数 * 取消`route:build`指令 * 调整默认模板目录为根目录`view ` * 取消默认的请求日志记录 在项目里面自己添加 * 统一`find`查询必须使用查询条件 * 扩展的service配置文件默认放到vendor目录下 * 废除`LogLevel`事件 * 取消App类的序列化方法 * 控制台的`user`配置改为通过静态方法设置当前执行用户 ## RC3（2019年6月3日） RC3版本主要改进和优化了系统内置中间件，改进了一些用法和体验，并且把不常用的驱动移出核心改为扩展方式提供。 ### 主要新特性 * 增加`whereWeek`日期查询 * 自增ID获取支持类型自动转换 * 当前请求记录匹配路由规则 * 增加`requireWithout`验证规则 * 优化路由ext和name方法以及URL生成 * 增加项目自定义类 * URL生成使用对象方式操作 * 修改器改进 * `dump`/`halt`助手函数调整支持输出多个变量 * 关联自动更新 * 模型数据集增加`delete`和`update`方法 * 模型支持表后缀以及动态切换 * 注解路由支持给某个路由指定所属分组 * 多语言支持分组定义 * 支持自定义加载语言文件 * 多语言定义支持YML格式 * 缓存标签改进 * 缓存类增加`push`方法 * Cookie保存时间支持DateTimeInterface * 增加表单令牌中间件 * 控制器支持__call方法 * 增加`deny_app_list`配置参数 * 控制器中间件only和except定义不区分大小写 * `app_map`支持指定泛应用映射 ### 问题修正 * 修正参数绑定的浮点型精度问题 * 修正软删除 * 修正模型的数据库连接 * 修正`RedirectResponse ` * 修正Session类`flush`方法 * 修正JSON字段参数绑定 * 修正`make:controller`指令生成 * 修正Cache类的`get`方法默认值 * 修正域名绑定 * 修正关联模型的动态获取器 * 修正模型`dateFormat`属性方法 * 修正url生成对多入口的支持 * 修正ini配置文件格式的布尔值转换问题 * 修正路由延迟解析全局配置无效的问题 * 修正路由缓存问题 * 修正关联`update`操作 * 修正`Relation::$selfRelation`默认为`null`，导致`Relation::isSelfRelation()`方法报错 * 修正`redis`缓存驱动 * 修正事件智能订阅`observe`方法 * 修正模型字段定义对日期查询无效的问题 * 修正Console类`getNamespaces`方法 * 修正`where`查询方法传入Query对象的时候缺少`bind`数据的问题 * 修正request类`method`方法 * 修正`route:list`指令 * 修正`Collection`类`load`方法 * 修正`redis`驱动的端口类型 * 修正`session`数据序列化使用JSON处理的问题 * 修正分组路由合并解析 * 修正模型的`hidden`方法隐藏关联模型的问题 * 修正关联查询关联键为空的错误 * 修正返回204状态码的响应判断 * 修正`Request`类`has`方法对`env`和`session`的支持 * 修正`provider.php`文件无效问题 * 修正关联查询的部分问题 * 修正validate助手函数支持指定验证器类 * 修正验证类`getValidateType`方法 * 修正入口单独开启调试模式 * 修正加载Composer应用 ### 用法调整 * 页面trace中间件仅在调试模式有效 * `Socket`日志驱动移出核心 * `PostgreSQL`、`Sqlite`和`SqlServer`驱动移出核心 ，改为扩展 * 取消内置`think\Controller`基类 * `Yaconf`支持移出核心 纳入扩展`think-yaconf` * 字段排除改为`withoutField`方法 * 取消`useGlobalScope`方法增加`withoutGlobalScope`方法 * 更改默认生成的中间件位置 * 加载默认语言包无需开启多语言中间件 * `Cookie`类恢复`get`和`has`方法支持 * `token`助手函数调整 * 全局请求缓存参数调整 * 统一中间件调用传参，不支持`:`分割传参 * 缓存数据统一进行序列化后存储 * Cache类rm方法更改为delete方法 * validate助手函数返回Validate对象实例，参数改变 ### 废弃用法 * 取消多语言的`auto_detect`配置 * 取消`session`类的`auto_start`配置参数和`boot`方法 * 废弃`Where`数组对象查询 * 取消模型事件观察者 * 取消`JumpResponse`及`success`/`error`/`result`等方法和助手函数 * 取消表达式查询解析扩展及`think\db\Expression`类 * 废弃模型自动完成功能，使用模型事件替代 * 取消`cookie`的`prefix`参数 * 取消一系列不推荐使用的助手函数 * 取消`optimize:facade` `optimize:model`指令 改为扩展方式 * 取消命令行执行URL * 删除`Config`类`__get` 和 `__isset` 方法 ## RC2（2019年4月22日） 相比较`RC1`版本更新调整较大，主要更新如下： * 底层架构针对协程做优化调整 * 增加WEB应用管理类`Http` * 增加应用初始化服务和服务注册机制 * 查询事件和模型事件使用事件系统接管 * `Session`类重构，不再使用PHP内置会话 * `Cookie`类仅支持设置和写入，不再支持读取 * 取消`Config`类的动态设置功能 * 部分核心功能中间件化（页面Trace、多语言、请求缓存和Session初始化） * 取消惯例配置文件 * 增加驱动接口规范驱动开发 * 改进Db类和查询类 * 精简一些不必要的类库 * 改进路由注册 * 由于异常的需要`View`类改为内置，但默认仅支持原生PHP模板 * 大量细节改进和修正 ## RC1（2019年2月14日） * 改进Url类`build`方法 * 修复获取当前页码数据类型 * 修正`parseKey`方法传入数值的情况 * 改进`optimize:config`指令对`declare`申明的支持 * 取消URL参数模式配置 * 增加`optimize:facade`指令用于生成`facade`类的方法注释 * 取消`Query`类的`extend`方法 * 原来的`Expression`类更改为`Raw`类 * 增加新的`Expression`类用于表达式查询扩展 * `Collection`类增加`whereLike`/`whereNotLike`/`whereIn`/`whereNotIn`/`whereBetween`/`whereNotBetween`等快捷方法 * Query类的`raw`方法移动到Db类 * 取消`Request`类的`hook`方法 * 修正`Route::view`方法 * 优化模型获取器方法 * 多对多关联的`pivotDataName`方法更名为`name`方法 * Query类增加`partition`/`duplicate`/`extra`方法 * 改进mysql驱动支持分区和`duplicate`以及额外参数 * mysql驱动的`insert`方法改用更清晰的`insert set`语法 * 修正`Event`类`bind`属性定义 * 修正验证类的`append`一处bug * 改进`Query`类`update`方法支持读取模型的更新条件 * 取消模型类的`getUpdateWhere`方法统一使用`getWhere`方法 * 改进query类的`fetchArray`方法处理 * 改进路由类取消`app`属性 * 增加`think\facade\RuleName`类 * 增加`whereFieldRaw`查询方法 * 改进自动多应用名称获取 * App类增加`withEvent`方法支持关闭事件机制 * 改进`Dispatch`类对`var_dump`的支持 * 改进`hasMany`的`withCount`自关联 * 修正纯数字检测参数类型转换问题 * 修正`raw`助手函数 * `mysql`支持`find_in_set`查询 * 改进`url`方法对自动多应用的支持

`V6.0`版本保持兼容升级，但不兼容`5.*`版本的升级。 # `5.1`升级到`6.0`版本 >[danger] 不建议老的项目升级到新版，除非你有重构计划，否则就算升级了也只是表面上升级了。 > 本文主要用于指导开发者从`5.1`升级到`6.0`最新（RC）版本，由于`6.0`不支持`5.1`的无缝升级，下面的升级步骤和指导仅供学习参考，或有遗漏及考虑不周之处，因此不保证你的所有功能都能正常升级。 `6.0`版本必须使用`composer`安装，所以你需要首先安装新的`6.0`版本，然后把原来`5.1`的文件复制进去，完成升级工作。 ~~~cmd composer create-project topthink/think:6.0.0 tp ~~~ 安装完成后，把原来`application`目录下面的文件复制到`app`目录下面，然后把`config`和`route`目录下的文件复制到同名目录下。接下来，按照下面的步骤来升级操作。 从`5.1`多模块迁移到`6.0`的多应用后，应用类库的命名空间原则上可以无需调整，但不再支持跨应用调用（包括路由及模板，每个应用的路由是独立的），这点务必引起重视。如果你的应用根命名空间不是默认的`app`需要改成`app`。 [TOC=2,2] ## 第一步：应用配置 如果原来你使用了多模块开发模式，直接改成新版的多应用模式是最简单的，需要额外安装多应用模式扩展。 ``` composer require topthink/think-multi-app ``` 如果你自定义了访问控制器的名称，需要修改`route.php`配置文件中的`controller_layer`值。 ``` // 访问控制器层名称 'controller_layer' => 'controller', ``` 如果你开启了控制器类的后缀，需要设置`route.php`配置文件中的`controller_suffix`值。 ``` // 开启控制器后缀 'controller_suffix' => true, ``` 如果自定义了空控制器的名称，则需要设置`route.php`配置文件中的`empty_controller`值。 ``` // 空控制器名 'empty_controller' => 'Error', ``` ## 第二步：配置调整 请按照如下顺序检查及调整你的配置文件和相关配置代码。 ### 应用的配置文件 如果是多应用的话，应用配置文件应当放入应用下的`config`目录。全局配置文件位置无需调整。 ### 配置获取调整 原来获取一级配置参数的方式 ``` Config::pull('app'); ``` 需要改成 ``` Config::get('app'); ``` 所有的配置读取必须从第一级配置开始，例如，原来的 ``` Config::get('exception_handle'); ``` 必须改成 ``` Config::get('app.exception_handle'); ``` ### 废弃动态设置 动态更改配置参数的用法已经废弃，下面的用法不再支持。 ``` Config::set('route.default_return_type', 'json'); ``` 如果你需要把数据库的配置参数读入配置，可以使用 ``` $config = Db::name('config')->column('value', 'name'); Config::set($config, 'route'); ``` ### `Config`类不再支持数组方式读取 `Config`类不再使用`ArrayAccess`接口，因此不再支持数组方式读取。 ### 路由和URL配置独立 路由和URL请求相关的配置参数独立为`route.php`配置文件，而不再使用`app.php`配置文件。 ## 第三步：路由和请求调整 ### 路由定义文件位置调整 单应用模式下，路由定义文件和之前一样就在`route`目录下面，如果你的项目是采用了多应用模式的话，每个应用的路由定义和匹配都是独立的，也没有模块的概念，路由定义文件的位置应该是在`应用/route`下面，例如： ~~~ app/index/route/route.php // index应用的路由定义文件 app/index/route/web.php // index应用的第二个路由定义文件 app/admin/route/route.php // admin应用的路由定义文件 ~~~ > 应用的路由规则其实是定义的入口文件（或者应用名）后面的URL部分，而不包含应用。 ### 路由注册方法调整 首先如果你的路由定义采用的是返回数组形式，全部改成方法定义。 例如： ~~~ return [ 'hello/:name' => 'index/hello', ]; ~~~ 必须改成： ~~~ Route::get('hello/:name', 'index/hello'); ~~~ 如果路由定义方法（包括`rule`/`get`/`post`/`put`/`delete`/`patch`/`miss`/`group`等方法）使用了`option`和`pattern`参数，全部改成方法调用形式，例如原来的： ~~~ Route::get('hello/:name', 'index/hello', [ 'ext' => 'html'], [ 'name' => '\w+']); ~~~ 需要改成 ~~~ Route::get('hello/:name', 'index/hello') ->ext('html') ->pattern([ 'name' => '\w+']); ~~~ ### 路由分组调整 如果路由分组定义使用了数组，改成闭包方式定义，例如： ~~~ Route::group('blog', [ ':id' => 'Blog/read', ':name' => 'Blog/read', ])->ext('html')->pattern(['id' => '\d+']); ~~~ 必须改成 ~~~ Route::group('blog', function() { Route::get(':id', 'Blog/read'); Route::get(':name', 'Blog/read'); })->ext('html')->pattern(['id' => '\d+']); ~~~ 如果你需要注册一个虚拟的路由分组，可以直接在第一个参数使用闭包 ~~~ Route::group(function() { Route::get('blog/:id', 'Blog/read'); Route::get('user/:name', 'User/read'); })->ext('html')->pattern(['id' => '\d+']); ~~~ ### 取消了`url_controller_layer`配置 改为在`route.php`配置文件中使用`controller_layer`设置。 ### 取消`controller_suffix`配置 改为在`route.php`配置文件中使用`controller_suffix`设置。 同时`class_suffix`配置参数已经无效。 ### 取消`mergeExtraVars`方法和对应参数 改为在路由规则中明确指定变量规则。 ### `allowCrossDomain`方法参数调整 取消原来的第一个参数。 ### `header`方法取消 需要单独改变Header信息的直接通过中间件统一处理。 ### 取消`Request`类的`hook`方法 该方法已经在最新版本中取消。如果你使用了该功能，在自定义请求对象`app\Request`中直接增加相应的方法即可。并确保`provider.php`文件中添加如下绑定： ``` 'think\Request' => \app\Request::class, ``` ### 取消`URL`参数模式配置 原来的URL参数模式配置参数`url_param_type`，统一使用参数/值的方式。如果你设置了该配置参数为1，必须改成定义路由的方式。 ### 取消别名路由 因为使用场景有限和性能开销问题，取消原来的别名路由功能，建议使用资源路由或者单独的路由替代。 ### 取消快捷路由 因为使用场景有限和不太符合规范，取消了原来的控制器快捷路由功能。 ### 取消空操作功能 建议使用分组MISS路由功能或者控制器的`__call`方法替代。 ## 第四步：控制器和视图调整 ### `think\Controller`类取消 系统不再提供基础控制器类`think\Controller`，原来的`success`、`error`、`redirect`和`result`方法需要自己在基础控制器类里面实现。 系统默认在应用目录下面提供了一个`app\BaseController`基础类，或者你可以直接放入你的应用里面，继承使用。 你可以安装下面的扩展用于支持旧版本的跳转操作 ~~~ composer require liliuwei/thinkphp-jump ~~~ ### 视图和模板引擎从核心分离 模板引擎类不再内置到核心框架，但使用 ~~~ composer create-project topthink/think ~~~ 会默认安装该组件（如果不需要使用的话可以自己卸载`topthink/think-view`）。 安装后，由于内置的`think\Controller`类已经取消，如果你的控制器类需要调用`fetch`/`display`/`assign`等视图方法，必须改为调用`think\facade\View`类，如果是使用`view`助手函数方式的话，可以无需调整。 ``` View::assign('name', $name); View::fetch(); ``` ### `share`方法取消 原来视图类的`share`方法取消，可以使用 ``` think\facade\View::assign($vars); ``` ## 第五步：数据库和模型调整 ### `Db`改为使用门面对象 新版的`Db`类不再是静态类，需要使用`think\facade\Db`门面进行静态代理。 ~~~ \think\facade\Db::name('user')->find(); ~~~ ### 数据库配置信息调整 数据库配置文件或者`connect`方法取消`DSN`数据库配置定义方式，全部采用数组方式配置定义。 ~~~ Db::connect('mysql://root:1234@127.0.0.1:3306/thinkphp#utf8') ->table('user') ->find(); ~~~ 必须改成 ~~~ Db::connect('db_config') ->table('user') ->find(); ~~~ 并且按照新版的规范在数据库配置文件中增加`db_config`连接信息。 ### 取消`fetchPdo`方法 取消了`Query`类的`fetchPdo`方法，需要的时候直接使用`getPdo`方法替代。 ### 取消查询方法传入`Query`对象 取消Query类的CURD查询方法传入当前对象，如果需要请使用闭包替代。 ### `insert`/`insertGetId`/`insertAll`方法取消`replace`参数 `insert`/`insertGetId`/`insertAll`方法的第二个`replace`参数已经取消，改为使用`replace`方法。 ~~~ $data = ['foo' => 'bar', 'bar' => 'foo']; Db::name('user')->insert($data, true); ~~~ 需要改为 ~~~ $data = ['foo' => 'bar', 'bar' => 'foo']; Db::name('user')->replace()->insert($data); ~~~ ### 取消`db`和`model`助手函数 这两个助手函数`5.1`版本已经不再建议使用了，`6.0`版本已经废弃掉这两个助手函数，请直接使用`\think\facade\Db`类静态方法和实际的模型类调用。 ### 取消`setInc`/`setDec`方法 取消Query类的`setInc`/`setDec`方法，统一使用`inc`/`dec`方法替代。例如： ~~~ Db::name('user')->where('id', 1) ->inc('exp') ->dec('score') ->update(); ~~~ ### 取消`join`方法的批量操作 `join`方法不再支持批量操作多个表，如果你使用了`join`方法批量操作，需要改成每个表单独调用一次`join`方法。 ### 取消`setField`方法 取消Query类的`setField`方法，请直接使用`data`方法或者`update`方法。 ### 取消`__TABLE_NAME__`支持 `table`方法取消`__TABLE_NAME__`支持，必须明确调用完整表名或者使用`name`方法。 ### 取消`whereOr`等方法传入`Query`对象 因为`Query`对象查询只能使用一次，除了`where`方法本身可以传入`Query`对象外，其它的所有`where`查询方法（例如`whereOr`/`whereExp`等）都不再支持传入`Query`对象。 ### 取消`resultset_type`配置参数 数据集查询结果不再受`resultset_type`配置参数影响，默认情况下，Db查询统一返回数组，模型查询统一返回模型对象和模型数据集对象。如果Db查询的时候也需要返回数据集的话，可以显式调用`fetchCollection`方法。 ### 取消`Query`类的`extend`方法 取消了`Query`类的`extend`方法，如果需要扩展查询方法，建议自定义`Query`类并继承系统的`think\db\Query`类即可，然后在模型中定义`query`属性或者配置数据库连接的`query`参数为你的自定义类。 ### `Expression`对象调整 原来的`Expression`对象已经更改为更适合的`Raw`对象，但不影响`Db::raw()`方法的调用。 ### 取消查询`eq/neq/gt/lt/egt/elt`表达式 由于存在两种用法，并且不够直观，全部统一为更直观的用法。 下面的用法不再支持 ~~~ Db::name('user')->where('id', 'egt', 1) ->where('status', 'neq' ,1) ->select(); ~~~ 统一使用 ~~~ Db::name('user')->where('id', '>=', 1) ->where('status', '<>' ,1) ->select(); ~~~ ### 取消分表功能 出于分表的性能问题和复杂性，不再提供分表方法，建议使用数据库的分区功能替代。新版可以使用`partition`方法指定当前查询的分区。 ### 数据库的查询统计合并 数据库的查询次数合并到`queryTimes`，不再区分读写操作，你可以使用下面的方法获取当前请求的数据库查询次数（包括读写） ~~~ Db::getQueryTimes(); ~~~ ### 模型后缀 如果之前开启了类库后缀功能的话，你必须在模型类里面明确指定`name`属性。 ### 取消了模型的`get`/`all`方法 无论使用`Db`类还是模型类查询，全部统一使用`find`/`select`方法，取消了之前模型类额外提供的`get`/`all`方法。同时取消的方法还包括`getOrFail`/`allOrFail`。 ### 取消全局查询范围`base`方法 取消模型类的全局查询范围`base`方法，改由使用`globalScope`属性定义（数组）需要全局查询的查询范围方法。 ### 模型事件调整 模型事件不再需要使用`event`方法注册事件，统一在模型类中定义事件方法，例如 ~~~ extra = 'extra'; } public function onBeforeWrite($user) { $user->extra = 'extra'; } } ~~~ 并且模型增加`after_read`事件，在查询后创建模型对象实例的时候触发。 ### 取消模型自动完成 模型的自动完成功能已经取消，请使用模型事件代替。 ### 模型`save`方法调整 模型类的`save`方法不再支持`where`参数。 ### 关联统计调整 如果你的关联统计使用了闭包方式返回关联统计字段，需要调整为如下方式： ``` User::withCount(['cards' => function($query,&$name) { $query->where('status', 1); $name = 'card_count'; }])->select(); ``` ### 模型和数据集的输出调整 取消`hidden`/`visible`/`append`方法的第二个参数，当你调用这几个方法的时候，无论模型是否设置了相关属性，都会直接覆盖之前设置的值。 ### 查询缓存调整 如果希望在更新和删除之后自动清除之前的查询缓存，必须在`cache`方法中传入key值而不是`true`。 ### 删除关联类`selfRelation`方法 如果你在定义关联的时候使用了`selfRelation`方法，请直接删除该方法，目前已经不再需要，会自动识别是否为自关联。 ### 删除关联类的`setEagerlyType`方法 一对一关联无需在定义关联的时候指定为`JOIN`查询，在查询的时候直接使用`withJoin`方法即可使用`JOIN`方式进行关联查询。 ### 多对多关联 多对多关联的`pivotDataName`方法更名为更简单的`name`方法。 ## 第六步：行为调整 行为和`Hook`已经用新版的事件机制替代，需要把你的行为改成事件响应或者中间件（部分请求拦截的行为可以直接改为中间件）。 原来的系统内置钩子的行为类 ~~~ [ 'AppInit' => ['\app\index\listener\Hello'], // 更多事件监听 ], ]; ~~~ 修改完成后，你可以删除应用目录下不再使用的`tags.php`文件。 内置事件和钩子的对应关系如下： | 事件| 对应`5.1`钩子| 参数 | | --- | --- | --- | | `AppInit` | `app_init `| 无 | | `AppEnd` | `app_end `| 当前响应对象实例 | | `LogWrite` | `log_write `| 当前写入的日志信息 | | `LogLevel` | `log_level `| 包含日志类型和日志信息的数组 | >[danger] 原来的`app_begin`、`response_send`、`response_end`、`action_begin`、`module_init`和`view_filter`钩子已经废弃。 ## 第七步：其它调整及注意事项 ### 系统`Facade`类库别名取消 系统`Facade`类库的别名已经取消，因此不能再使用 ``` use Route; Route::rule('hello/:name', 'index/hello'); ``` 必须使用 ``` use think\facade\Route; Route::rule('hello/:name', 'index/hello'); ``` ### `Session`调整 `Session`新版默认不开启，必须为在全局中间件定义文件中添加 ~~~ 'think\middleware\SessionInit' ~~~ 原来的`Session::get()` 可以获取全部的Session数据必须改成 `Session::all()` ### 严格类型检查 由于新版框架核心类库全面启用强类型参数，并且使用严格模式，所以在调用系统方法的时候一定要注意参数的类型，或者注意看抛出的异常信息进行修正。 >[success] 最后，希望你的`6.0`升级之旅顺利^_^ ，希望大家在升级和使用`6.0`的过程中，多反馈和建议，帮助我们尽快完善和发布正式版本。

## 助手函数 系统为一些常用的操作方法封装了助手函数，便于使用，包含如下： | 助手函数 | 描述 | | --- | --- | | abort | 中断执行并发送HTTP状态码 | | app | 快速获取容器中的实例 支持依赖注入 | | bind | 快速绑定对象实例 | | cache | 缓存管理 | | class_basename | 获取类名(不包含命名空间) | | class_uses_recursive | 获取一个类里所有用到的trait | | config | 获取和设置配置参数 | | cookie | Cookie管理 | | download| 获取\think\response\File对象实例 | | dump | 浏览器友好的变量输出 | | env | 获取环境变量 | | event| 触发事件| | halt | 变量调试输出并中断执行 | | input | 获取输入数据 支持默认值和过滤 | | invoke | 调用反射执行callable 支持依赖注入 | | json | JSON数据输出 | | jsonp | JSONP数据输出 | | lang | 获取语言变量值 | | parse_name | 字符串命名风格转换 | | redirect | 重定向输出 | | request | 获取当前Request对象 | | response | 实例化Response对象 | | session | Session管理 | | token | 生成表单令牌输出 | | trace | 记录日志信息 | | trait_uses_recursive | 获取一个trait里所有引用到的trait | | url | Url生成 | | validate | 实例化验证器 | | view | 渲染模板输出 | | display| 渲染内容输出 | | xml | XML数据输出 | | app_path| 当前应用目录 | | base_path| 应用基础目录 | | config_path| 应用配置目录 | | public_path| web根目录 | | root_path| 应用根目录 | | runtime_path| 应用运行时目录 | >[danger] 可以在应用的公共函数文件中重写上面这些助手函数。

[助手函数](%E5%8A%A9%E6%89%8B%E5%87%BD%E6%95%B0.md) [升级指导](%E5%8D%87%E7%BA%A7%E6%8C%87%E5%AF%BC.md) [更新日志](%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97.md)

本篇内容主要讲述了最新的`think-swoole`扩展的使用。目前仅支持Linux环境或者MacOs下运行，要求`swoole`版本为`4.3.1+`。 > 由于 `think-swoole`是基于`swoole`的，要了解这个扩展如何使用，首先需要对`swoole`有一定的了解，这也是本文阅读的前提，具体可以参考 Swoole官方文档内容：[https://wiki.swoole.com](https://wiki.swoole.com) ## 安装 首先按照`Swoole`官网说明安装`swoole`扩展，然后使用 ~~~ composer require topthink/think-swoole ~~~ 安装`think-swoole`扩展。 >[danger] 由于`Swoole`不支持`windows`环境，所以你无法在`windows`环境下测试，只能使用虚拟机或者`WSL`环境测试。 ## `HTTP`服务 直接在命令行下启动HTTP服务端。 ~~~ php think swoole ~~~ 启动完成后，默认会在`0.0.0.0:80`启动一个HTTP Server，可以直接访问当前的应用。相关配置参数可以在`config/swoole.php`里面配置（具体参考配置文件内容）。 支持的其它操作包括： 启动HTTP服务（默认） ~~~ php think swoole start ~~~ 停止服务 ~~~ php think swoole stop ~~~ 重启服务 ~~~ php think swoole restart ~~~ `reload`服务 ~~~ php think swoole reload ~~~ ### 守护进程模式 如果需要使用守护进程方式运行，可以配置 ~~~ 'options' => [ 'daemonize' => true ] ~~~ ## 热更新 由于`Swoole`服务运行过程中PHP文件是常驻内存运行的，这样可以避免重复读取磁盘、重复解释编译PHP，以便达到最高性能。所以更改业务代码后必须手动`reload`或者`restart`才能生效。 `think-swoole`扩展提供了热更新功能，在检测到相关目录的文件有更新后会自动`reload`，从而不需要手动进行`reload`操作，方便开发调试。 如果你的应用开启了调试模式，默认是开启热更新的。原则上，在部署模式下不建议开启文件监控，一方面有性能损耗，另外一方面对文件所做的任何修改都需要确认无误才能进行更新部署。 热更新的默认配置如下：  当我们在应用的根目录下定义一个特殊的`.env`环境变量文件，里面设置了`APP_DEBUG = true`会默认开启热更新，你也可以直接把`enable`设置为true。 参数说明： | 参数 | 说明 | | --- | --- | | enable | 是否开启热更新 | | name | 简单点说就是监控那些类型的文件变动 | | include | 简单点说就是监控那些路径下的文件变动 | | exclude | 排除目录 | ## 连接池 `think-swoole` 默认有实现数据库和缓存连接池功能，涵盖了日常开发的主要场景。 最新的`swoole`版本支持[一键协程](https://wiki.swoole.com/#/runtime)，比如`redis`、`mysql`等等，很方便。连接池是在这个基础上，解决一些问题和对性能的再一次提升。 要开启一键协程，需要配置如下参数  这里需要设置为true，默认已经打开，flags默认即可。 连接池的配置参数如下：  参数说明： | 参数 | 说明 | | --- | --- | | enable | 开关，不需要设置false | | max\_active | 最大连接数，超过将不再新建连接 | | max\_wait\_time | 超时时间 | 其中的`max_active`和`max_wait_time`需要根据自身业务和环境进行适当调整，最大化提高系统负载。

## 安装 首先使用`Composer`安装`think-captcha`扩展包： ~~~ composer require topthink/think-captcha ~~~ >[danger] 验证码库需要开启Session才能生效。 ## 使用 扩展包内定义了一些常见用法方便使用，可以满足大部分常用场景，以下示例说明。 在模版内添加验证码的显示代码 ~~~ ~~~ 或者 ~~~ ~~~ > 上面两种的最终效果是一样的，根据需要调用即可。 然后使用框架的内置验证功能（具体可以参考验证章节），添加`captcha`验证规则即可 ~~~ $this->validate($data,[ 'captcha|验证码'=>'require|captcha' ]); ~~~ 如果没有使用内置验证功能，则可以调研内置的函数手动验证 ~~~ if(!captcha_check($captcha)){ // 验证失败 }; ~~~ 如果是多应用模式下，你需要自己注册一个验证码的路由。 ``` Route::get('captcha/[:config]','\\think\\captcha\\CaptchaController@index'); ``` ## 配置 `Captcha`类带有默认的配置参数，支持自定义配置。这些参数包括： | 参数 | 描述 | 默认 | | --- | --- | --- | | codeSet | 验证码字符集合 | 略 | | expire | 验证码过期时间（s） | 1800 | | math| 使用算术验证码 | false | | useZh | 使用中文验证码 | false | | zhSet | 中文验证码字符串 | 略 | | useImgBg | 使用背景图片 | false | | fontSize | 验证码字体大小(px) | 25 | | useCurve | 是否画混淆曲线 | true | | useNoise | 是否添加杂点 | true | | imageH | 验证码图片高度，设置为0为自动计算 | 0 | | imageW | 验证码图片宽度，设置为0为自动计算 | 0 | | length | 验证码位数 | 5 | | fontttf | 验证码字体，不设置是随机获取 | 空 | | bg | 背景颜色 | \[243, 251, 254\] | | reset | 验证成功后是否重置 | true | 直接在应用的`config`目录下面的`captcha.php`文件中进行设置即可，例如下面的配置参数用于输出4位数字验证码。 ``` return [ 'length' => 4, 'codeSet' => '0123456789', ]; ``` ## 自定义验证码 如果需要自己独立生成验证码，可以调用`Captcha`类（`think\captcha\facade\Captcha`）操作。 在控制器中使用下面的代码进行验证码生成： ~~~