# 升级指导 [TOC=2,2] ## 从V5.0.19升级到V5.0.20 支持无缝升级 ## 从V5.0.18升级到V5.0.19 支持无缝升级 ## 从V5.0.17升级到V5.0.18 由于`5.0.18+`更具严谨性,如果数组查询条件中使用了`exp`查询,必须做出如下调整: ~~~ // 错误 $where['id'] = ['exp', '>score']; $model->where($where)->find(); // 正确 $where['id'] = ['exp', Db::raw('>score')]; $model->where($where)->find(); // 正确 推荐写法 $model->whereExp('id', '>score')->find(); ~~~ 如果需要使用`exp`表达式更新数据,必须使用`Db::raw()`方法或者`exp`方法。下面用法不再支持: ~~~ // 错误 不再支持 $data['score'] = ['exp', 'score+1']; $model->where('id', 1)->update($data); // 正确 $data['score'] = Db::raw('score+1'); $model->where('id', 1)->update($data); // 正确 推荐用法 $model->where('id', 1)->exp('score', 'score+1')->update(); ~~~ ## 从V5.0.16升级到V5.0.17 >[danger] 如果你使用了闭包查询条件,并且使用了默认的查询缓存`cache()`或者`cache(true)`,新版本会抛出异常,请使用`cache('key')`替代,避免因为查询缓存无效而影响业务。 > 如果你在`order`方法中使用了SQL函数,请使用`orderRaw`方法或者`Db::raw()`方法替代。 对于复杂的`field/where/order`字符串参数的,如果发现存在错误,尽量使用`fieldRaw/whereRaw/orderRaw`替代(只能传入字符串参数)。 ## 从V5.0.15升级到V5.0.16 ### 默认模板渲染规则改进 由于`fetch`方法和`view`函数的默认模板规则调整为操作方法的名称(不含操作后缀)转换为小写+下划线方式,而不是原来的直接把操作名称转小写。 举个例子,你的控制器操作方法名如果是`helloWorld`,之前版本使用: ~~~ $this->fetch(); // 或者 view(); ~~~ 渲染输出的时候会定位到 `helloworld.html`模板文件,而新版会自动定位到`hello_world.html`模板文件。 > 对于指定模板渲染的`fetch`方法和`view`助手函数不受影响,对于非驼峰操作方法名也没有影响。 ## 从V5.0.14升级到V5.0.15 `V5.0.14`可以无缝升级到`V5.0.15`。 ## 从V5.0.13升级到V5.0.14 `V5.0.13`可以无缝升级到`V5.0.14`。 ## 从V5.0.12升级到V5.0.13 `V5.0.12`可以无缝升级到`V5.0.13`,如果使用了Redis缓存,需要清空下Redis缓存数据的内容。 ## 从V5.0.11升级到V5.0.12 `V5.0.11`可以无缝升级到`V5.0.12`。 ## 从V5.0.10升级到V5.0.11 `V5.0.10`可以无缝升级到`V5.0.11`。 >[danger] 升级完成后请务必清空下数据缓存。 ## 从V5.0.9升级到V5.0.10 `V5.0.9`可以无缝升级到`V5.0.10`。 ## 从V5.0.8升级到V5.0.9 `V5.0.8`可以无缝升级到`V5.0.9`。 ## 从V5.0.7升级到V5.0.8 如果自定义了应用的命名空间的话,原来的`app_namespace`配置参数改为`APP_NAMESPACE`常量在入口文件中定义 如果使用了多对多关联,并且定义了中间表,那么中间表改为去掉前缀后的数据表名。 模型的scope方法之后只能使用数据库查询方法而不能使用模型的方法。 ## 从V5.0.6升级到V5.0.7 `V5.0.6`可以无缝升级到`V5.0.7`。 ## 从V5.0.5升级到V5.0.6 `V5.0.5`可以无缝升级到`V5.0.6`。 由于数据库缓存策略的改进,之前如果使用了数据缓存,请先清空下数据缓存。 之前因为升级到5.0.5版本后 时间字段使用整型后也会自动格式化输出的问题,现在可以设置数据库的配置参数 `datetime_format`值为`false`即可关闭自动转换。 另外,注意,如果使用了`MongoDb`数据库扩展的话,请删除数据库配置文件中的`query`参数。 ## 从V5.0.4升级到V5.0.5 从`V5.0.4`升级到`V5.0.5`需要注意如下事项: 模型的时间日期字段会自动进行格式化输出,不需要进行额外处理。 原生查询不再支持返回数据集对象。 `Connection`类的`model`方法已经更改为`getQuery`。 关联定义方法的`alias`参数已经废弃。 分页查询返回类型变成`think\Paginator`(用法不变)。 数据缓存自动采用子目录方式避免缓存数据文件过多影响性能。 Session类添加了`secure`和`httponly`参数,并且默认是true,如果不支持请手动关闭。 ## 从V5.0.3升级到V5.0.4 从`V5.0.3`升级到`V5.0.4`需要注意如下事项: 模型的关联定义方法必须采用驼峰法(小写字母打头)命名规范,但关联调用可以支持驼峰和小写方式。 行为类的方法必须使用驼峰法命名,如果你使用了钩子位作为行为执行方法入口,请修改为驼峰法,例如 `app_init`钩子位对应的行为方法名应该是 `appInit`。 如果你使用了Query类的`fetchClass`方法自定义数据集返回对象的话,请改为在模型中设置`resultSetType`属性,数据库类不再支持自定义查询数据集对象(只支持数组和系统的`think\Collection`数据集对象) ## 从V5.0.2升级到V5.0.3 从`V5.0.2`升级到`V5.0.3`需要注意如下事项: 对于join方法和view方法使用子查询的情况,请尽量使用数组方式: >[info] ['子查询'=>'别名'] ## 从V5.0.1升级到V5.0.2 从`V5.0.1`升级到`V5.0.2`需要注意如下事项: 下列模型属性和方法由原来的静态(static)定义改为动态定义: * 聚合模型的`relationModel`属性 * Model类的`useGlobalScope` 属性 * 软删除属性 `deleteTime`属性 * 全局查询范围方法`base`改为动态方法 原来的`join`方法和`view`方法的第一个参数规范化,支持下面三种用法: >[info]#### 用法一:[ '带前缀表名'=>'别名' ] >#### 用法二:'带前缀表名 别名' >#### 用法三:'不带前缀的表名' 如果有其它用法注意调整,下面的用法不再支持: >[info] #### '不带前缀表名 别名' 如果使用了空操作方法,无需给`_empty`方法添加任何参数,当前操作名的获取直接使用请求对象的`action`函数获取。 ## 从V5.0升级到V5.0.1 从`V5.0`升级到`V5.0.1`需要注意如下事项: * 扩展配置参数`extra_config_list`废弃,除了数据库配置之外的扩展配置放入`application/extra`目录自动识别加载。 * 模型的`field`属性无需配置字段类型 * 查询构建器使用手动参数绑定的时候不要使用`?`号占位绑定,使用命名参数绑定 * 如果使用了`file_get_contents('php://input')`请改为`Request`对象的`getInput()` 方法获取 * 文件`File`类取消`md5()`和`sha1()`方法,请使用`hash('md5')`和`hash('sha1')`方法替代 ## 从V5.0RC4升级到V5.0 可以轻松的从RC4版本升级到正式版,不过请注意如下事项: * 如果定义了路由映射(静态路由)的则改为普通路由规则定义 * 定义了路由规则之后,原来的URL地址被禁止访问,请注意检查是否还有这种情况 * 如果配置了url_deny_suffix参数,改为路由的deny_ext参数设置 * 模型save方法返回值改为影响的记录数,并且方法参数中取消了getId参数 * Request对象controller方法返回驼峰控制器名,如果使用该方法渲染模板的话,请使用Loader::parseName(Request::instance()->controller())转换 * 如果使用了Sqlsrv驱动则,原来自动转换小写数据表字段默认不对数据表字段进行小写转换,请更改PDO::ATTR_CASE参数 * 如果部署在sae 需要使用sae扩展包 * 如果使用了Sqlsrv/Orace/Firebird驱动,则自行添加原来的驱动文件 * 配置参数读取的时候取消环境变量判断,需要读取环境变量的时候改用Env类 * 环境变量定义文件更改为 .env 由原来的PHP数组改为ini格式定义(支持数组方式) * 状态配置和扩展配置的加载顺序调整 便于状态配置文件中可以更改扩展配置的参数 * 取消域名绑定到路由分组功能 * 控制器类的success和error方法url参数支持传入空字符串,则不做任何处理 >[danger]### 关键几点: > 默认模板目录全部是小写+下滑线规范; > 控制器类的success、error和redirect方法无需使用return; > 模型的save方法返回值更改为影响的记录数,而非主键,使用model->id方式获取主键; > 路由定义后不能再使用原来URL地址访问; ## 从V3.2版本升级到V5.0 3.2版本无法直接升级到5.0版本,这里只是给出了升级指导思想和为了使用`3.X`版本的开发者更快的熟悉并上手这个全新的版本。同时也强烈建议开发者抛弃之前旧的思维模式,因为`5.0`是一个全新的颠覆重构版本。 ### 需要摒弃的3.X旧思想 ### URL的变动 首先对3.X的不严谨给开发者们带来的不正确的引导表示歉意,在5.0版本正式废除类似/id/1方式 可以通过get获取到id的方法,严格来讲这样的url是不属于$_GET的,现在可以通过param获取,具体使用可以通过请求部分查询。 ### 模型的变动 新版的模型查询返回默认对象,系统默认增加了toArray方法,许多开发者在all或select尝试使用toArray来转换为数组,在此希望开发者能理解对象的概念,尝试使用对象进行数据的使用,或者使用db方法进行数据库的操作,也提醒一下部分滥用toArray的开发者,all或select结果是对象的数组集合,是无法使用toArray进行转换的。 ### 新版变化 ### 命名规范 * 目录和文件名采用‘小写+下划线’,并且以小写字母开头; * 类库、函数文件统一以.php为后缀; * 类的文件名均以命名空间定义,并且命名空间的路径和类库文件所在路径一致(包括大小写); * 类名和类文件名保持一致,并统一采用驼峰法命名(首字母大写) ### 函数 * 系统已经不依赖任何函数,只是对常用的操作封装提供了助手函数; * 单字母函数废弃,默认系统加载助手函数,具体参考上一个章节‘助手函数’; ### 路由 5.0的URL访问不再支持普通URL模式,路由也不支持正则路由定义,而是全部改为规则路由配合变量规则(正则定义)的方式,具体这里不再赘述。 ### 控制器 控制器的命名空间有所调整,并且可以无需继承任何的控制器类。 * 应用类库的命名空间统一为app(可修改)而不是模块名; * 控制器的类名默认不带`Controller`后缀,可以配置开启`controller_suffix`参数启用控制器类后缀; * 控制器操作方法采用`return`方式返回数据,而非直接输出; * 废除原来的操作前后置方法; ### 版本对比 3.2版本控制器写法 ~~~ <?php namespace Home\Controller; use Think\Controller; class IndexController extends Controller { public function hello() { echo 'hello,thinkphp!'; } } ~~~ 5.0版本控制器写法 ~~~ namespace app\index\controller; class Index { public function index() { return 'hello,thinkphp!'; } } ~~~ 3.2版本控制器命名 ~~~ IndexController.class.php ~~~ 5.0版本控制器命名 ~~~ Index.php ~~~ 怎么才能在控制器中正确的输出模板 5.0在控制器中输出模板,使用方法如下: 如果你继承`think\Controller`的话,可以使用: ~~~ return $this->fetch('index/hello'); ~~~ 如果你的控制器没有继承 `think\Controller`的话,使用: ~~~ return view('index/hello'); ~~~ ### 模型 如果非要对比与旧版本的改进,模型被分为数据库、模型、验证器三部分,分别对应M方法、模型、自动验证,同时均有所加强,下面做简单介绍。 ### 数据库 5.0的数据库查询功能增强,原先需要通过模型才能使用的链式查询可以直接通过Db类调用,原来的M函数调用可以改用db函数,例如: 3.2版本 ~~~ M('User')->where(['name'=>'thinkphp'])->find(); ~~~ 5.0版本 ~~~ db('User')->where('name','thinkphp')->find(); ~~~ ### 模型 新版的模型查询增加了静态方法,例如: ~~~ User::get(1); User::all(); User::where('id','>',10)->find(); ~~~ 模型部分增强了很多功能,具体请查阅“模型章节”。 ### 自动验证 对比旧的版本,可以理解为之前的自动验证且不同于之前的验证; ThinkPHP5.0验证使用独立的`\think\Validate`类或者**验证器**进行验证,不仅适用于模型,在控制器也可直接调用,具体使用规则请参考“验证”章节,这里不再赘述。 ### 配置文件 新版对配置很多的配置参数或者配置层次都和之前不同了,建议大家要么看看代码,要么仔细通读下官方的开发手册,不要因为配置的问题浪费自己一整天的时间。 ### 异常 5.0对错误零容忍,默认情况下会对任何级别的错误抛出异常,并且重新设计了异常页面,展示了详尽的错误信息,便于调试。 ### 系统常量的废弃 5.0版本相对于之前版本对系统变化进行了大量的废弃,用户如果有相关需求可以自行定义 下面是废除常量 ~~~ REQUEST_METHOD IS_GET IS_POST IS_PUT IS_DELETE IS_AJAX __EXT__ COMMON_MODULE MODULE_NAME CONTROLLER_NAME ACTION_NAME APP_NAMESPACE APP_DEBUG MODULE_PATH等 ~~~ 部分常量可以在Request里面进行获取,具体参考“请求章节”。 > 再次说明本章节仅仅为之前使用3.X版本开发者快速理解5.0所写,具体5.0的功能还需要开发者通读手册。 ### 助手函数 `5.0`助手函数和`3.2`版本的单字母函数对比如下: |`3.2`版本|`5.0`版本| |---|---| |C|config| |E|exception| |G|debug| |L|lang| |T|废除| |I|input| |N|废除| |D|model| |M|db| |A|controller| |R|action| |B|废除| |U|url| |W|widget| |S|cache| |F|废除|