# 升级指导
>[danger] 升级前请做好备份
[TOC=2,5]
## 5.0.190312升级到5.0.190419
### 升级步骤
1.备份数据库,和程序
2.覆盖新版本到老版本
3. 清除缓存
## 5.0.190111升级到5.0.190312
### 升级步骤
1.备份数据库,和程序
2.覆盖新版本到老版本
3. 清除缓存
### 升级注意
此版本已经删除`phpoffice/phpspreadsheet`,`phpoffice/phpexcel`,`dompdf/dompdf`第三方库,请自行安装
## 5.0.181231升级到5.0.190111
### 升级步骤
1.备份数据库,和程序
2.覆盖新版本到老版本
3. 清除缓存
## 5.0.181212升级到5.0.181231
### 升级步骤
1.备份数据库,程序
2.覆盖新版本到老版本
3.清除缓存
### 升级注意
* php版本要求提升到`5.6` 如果你项目中不需要用到`phpoffice/phpspreadsheet`且php无法升级到`5.6`,可以运行`composer remove phpoffice/phpspreadsheet`删除第三方库
* 规范控制器`_initialize`方法为`initialize`
* 调整`cmf_theme_path,cmf_default_theme,cmf_admin_theme_path,cmf_admin_default_theme`到 `template` 配置下
* `hook,hook_one`方法取消`$extra`参数
> 以上升级不影响正常用户升级,如果你有更改核心,请注意!
## 5.0.180901升级到5.0.181212
### 升级步骤
1.备份数据库,程序
2.覆盖新版本到老版本
3.清除缓存
数据库用法调整
>[info] 所有涉及数据库操作中`count`,`max`,`min`,`avg`,`sum`请不要在参数中增加空格
## 5.0.180626升级到5.0.180901
### 升级步骤
1.备份数据库,和程序
2.覆盖新版本到老版本
3. 同步钩子列表,在后台管理->插件中心->钩子列表->同步钩子列表
4. 清除缓存
## 5.0.180525升级到5.0.180626
### 升级步骤
1.备份数据库,和程序
2.覆盖新版本到老版本
3. 打开程序目录下 `update/update 5.0.180525 to 5.0.180626.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
4. 升级后请删除 `data/runtime`目录
5. 清除缓存
### 前台默认模板渲染规则改进
`fetch`方法的默认模板规则调整为操作方法的名称(不含操作后缀)转换为小写+下划线方式,而不是原来的直接把操作名称转小写。
举个例子,你的控制器操作方法名如果是`helloWorld`,之前版本使用:
~~~
$this->fetch();
~~~
渲染输出的时候会定位到 `helloworld.html`模板文件,而新版会自动定位到`hello_world.html`模板文件。
> 对于指定模板渲染的`fetch`方法不受影响,对于非驼峰操作方法名也没有影响。
## 5.0.180508升级到5.0.180525
```
可无缝升级
```
## 5.0.180501升级到5.0.180508
```
可无缝升级
```
## 5.0.180123升级到5.0.180501
### 升级步骤
1.备份数据库,和程序
2.覆盖新版本到老版本
3. 同步钩子列表,在后台管理->插件中心(原插件管理)->钩子列表->同步钩子列表
4. 清除缓存
### 由于TP升级需要进行如下代码用法调整
#### 数据库`EXP`用法调整
如果数组查询条件中使用了`exp`查询,必须做出如下调整:
~~~
// 错误
$where['id'] = ['exp', '>score'];
$model->where($where)->find();
// 正确
$where['id'] = 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();
~~~
#### 缓存用法调整
>[danger] 如果你使用了闭包查询条件,并且使用了默认的查询缓存`cache()`或者`cache(true)`,新版本会抛出异常,请使用`cache('key')`替代,避免因为查询缓存无效而影响业务。
> 如果你在`order`方法中使用了SQL函数,请使用`orderRaw`方法或者`Db::raw()`方法替代。
对于复杂的`field/where/order`字符串参数的,如果发现存在错误,尽量使用`fieldRaw/whereRaw/orderRaw`替代(只能传入字符串参数)。
#### 默认模板渲染规则改进
由于`fetch`方法和`view`函数的默认模板规则调整为操作方法的名称(不含操作后缀)转换为小写+下划线方式,而不是原来的直接把操作名称转小写。
举个例子,你的控制器操作方法名如果是`helloWorld`,之前版本使用:
~~~
$this->fetch();
// 或者
view();
~~~
渲染输出的时候会定位到 `helloworld.html`模板文件,而新版会自动定位到`hello_world.html`模板文件。
> 对于指定模板渲染的`fetch`方法和`view`助手函数不受影响,对于非驼峰操作方法名也没有影响。
## 5.0.170927升级到5.0.180123
1.备份数据库,和程序
2.覆盖新版本到老版本
3. 打开程序目录下 `update/update 5.0.170927 to 5.0.180123.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
4. 升级后请删除 `data/runtime`目录
5. 同步钩子列表,在后台管理->插件中心(原插件管理)->钩子列表->同步钩子列表
6. 清除缓存
### 升级注意事项
**1.取消文章列表用户关联查询**
在文章列表中请将原来的`$vo.user_id`等用户相关信息获取改为`$vo.user.id`,`$vo.user.user_nickname`等
**2.优化注册和找回页面数字验证码获取逻辑**
此次升级中获取数字验证码时必须有图片验证码,防止有人用机器发送短信验证,请升级时注意此逻辑的变更
**文档已经同步到5.0.180123版本,请大家仔细阅读**
## 5.0.170808升级到5.0.170927
1. 覆盖新版本到老版本
2. 打开程序目录下 `update/update 5.0.170808 to 5.0.170912.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
3. 升级后请删除 `data/runtime`目录
## 5.0.170607升级到5.0.170927
1. 覆盖新版本到老版本
2. 打开程序目录下 `update/update 5.0.170607 to 5.0.170808.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
3. 打开程序目录下 `update/update 5.0.170808 to 5.0.170912.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
4. 升级后请删除 `data/runtime`目录
## 5.0.170520 RC4升级到5.0.170607
打开程序目录下 `update/update to 5.0.170607.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
## 5.0.170505 RC3升级到5.0.170520 RC4
打开程序目录下 `update/update to 5.0.170520.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
## 5.0.170422 RC2升级到5.0.170505 RC3
打开程序目录下 `update/update to 5.0.170505.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件
## 5.0.170401 RC1升级到5.0.170422 RC2
打开程序目录下 `update/update to 5.0.170422.sql` 把表前缀`cmf_`换成你自己的表前缀,然后执行此文件