升级指导 · ThinkCMF5开发手册

# 升级指导 >[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_`换成你自己的表前缀，然后执行此文件