升級指導 · 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_`換成你自己的表前綴，然后執行此文件