升級指導 · DolphinPHP1.6.0完全開發手冊-基于ThinkPHP5.1.42LTS的快速開發框架

# 【V1.5.1升級至V1.6.0】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 > 升級前，可能覆蓋一些文件，請確認這些文件你是否自己修改過，如果是，升級后記得再修改一次。 ## 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` ## 2.執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) >[info] 如果是授權用戶可登錄海豚官網后下載授權版補丁。 ## 3.注意事項由于本次更新涉及一處安全更新，系統默認行為日志功能禁止執行一些危險函數，如：eval、exec、system等，具體可查看文件：`config/system.php` ![](https://img.kancloud.cn/9b/db/9bdbfae890d04482f2fe70e91d2fdfef_936x639.png) 如果你的行為日志規則中需要用到一些被禁止的函數，請在此文件中去掉對應的函數名即可。 # 【V1.5.0升級至V1.5.1】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 ## 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` ## 2.執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) >[info] 如果是授權用戶可登錄海豚官網后下載授權版補丁。 ## 3.注意事項由于本次更新涉及一處安全更新，系統默認行為日志功能禁止執行一些危險函數，如：eval、exec、system等，具體可查看文件：`config/system.php` ![](https://img.kancloud.cn/9b/db/9bdbfae890d04482f2fe70e91d2fdfef_936x639.png) 如果你的行為日志規則中需要用到一些被禁止的函數，請在此文件中去掉對應的函數名即可。 # 【V1.4.5升級至V1.5.0】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 2.執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) >[info] 如果是授權用戶可登錄海豚官網后下載授權版補丁。 # 【V1.4.4升級至V1.4.5】下載補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) 然后覆蓋即可 # 【V1.4.3升級至V1.4.4】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 2.執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) >[info] 如果是授權用戶可登錄海豚官網后下載授權版補丁。 # 【V1.4.2升級至V1.4.3】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 2.執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) >[info] 如果是授權用戶可登錄海豚官網后下載授權版補丁。 # 【V1.4.0升級至V1.4.2】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 >[info] 由于1.4.1的更新內容未發布，所以直接跳過1.4.1版本，更新至1.4.2 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 2.執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) >[info] 如果是授權用戶可登錄海豚官網后下載授權版補丁。 # 【V1.3.3升級至V1.4.0】 >[danger]注意！本次升級了ThinkPHP核心版本至5.1.34LTS，由于TP5.0到TP5.1并非無縫升級，所以本次DolphinPHP升級也非無縫升級，因為需要修改的地方不少，所以不建議升級現有的舊項目，而且本次升級暫無提供升級補丁。如果真的要升級，請按下面的升級指導操作。 >[danger]在升級前，請注意**備份好站點**，并且先看下ThinkPHP官方的升級指導：[點此查看](http://www.hmoore.net/manual/thinkphp5_1/354155) >[danger]另外，ThinkPHP5.1要求PHP至少是5.6版本，請確保您的服務器上的PHP版本符合要求。 1.備份好您的項目（**非常非常非常重要！**） 2.在項目根目錄，也就是與`application`同級目錄下創建新目錄`config`，將原來的應用`extra`目錄下面的配置文件直接移動到`config`目錄下面。 3.下載DolphinPHP1.4.0完整安裝包：[鏈接](http://www.dolphinphp.com/getdolphin.html) 將安裝包解壓覆蓋到您的項目，如果您修改過DolphinPHP框架的源碼，請注意那些文件，以便覆蓋后重新再修改。 4.將`application`目錄下的`route.php`移動到上級目錄的`route`目錄下，由于TP5.1的路由不能關閉，所以會導致訪問后臺時也會按路由規則訪問，這點請注意。 5.刪除以下無用文件： ``` thinkphp/.travis.yml thinkphp/codecov.yml thinkphp/console.php thinkphp/library/think/controller/Rest.php thinkphp/library/think/controller/Yar.php thinkphp/library/think/log/driver/Test.php thinkphp/library/think/model/Merge.php thinkphp/library/traits/model/SoftDelete.php thinkphp/library/traits/think/Instance.php thinkphp/phpunit.xml thinkphp/start.php ``` 6.刪除runtime目錄 ## 其他修改完成以上步驟后，項目可能還不能正常運行，自己開發的模塊也要修改，需要注意以下幾點： **1.所有的內置類改為引入門面的方式** 也就是`use think\Cache;` 改為 `use think\facade\Cache;` 具體請參考：http://www.hmoore.net/manual/thinkphp5_1/353959 **2.所有類的初始化方法名`_initialize`要改為`initialize`** **3.索引數組查詢調整如下：** 比如5.0是這樣的 ``` $map = [ 'uid' => ['<>', 1], 'name' => 'ming' ]; ``` 5.1需要改成 ``` $map = [ ['uid', '<>', 1], ['name', '=', 'ming'] ]; ``` **4.模板替換參數取消了** 也就是`fetch()`方法內不再支持傳入`$replace`參數，所以包括插件和ZBuilder都不再支持傳入自定義模板替換參數 **5.TP5.1取消了所有常量** 需要用`Env::get()`獲取，比如`APP_PAT`要用`Env::get('app_path')`來代替，具體參考：http://www.hmoore.net/manual/thinkphp5_1/354155#5051_218 **6.DS要改為DIRECTORY_SEPARATOR** **7.需要輸出html內容的話，需要在變量后面使用函數raw，例如{$var|raw}方式替換** **8.Hook::listen()方法取消了額外參數** 所以插件的處理要注意參數的接收方式，并且插件里的鉤子方法的參數只能接受形參，不能接受實參。 >[info]**如果升級過程中，遇到問題或者發現bug，請到論壇的指定貼內回復。再次之前，請認真閱讀ThinkPHP5.1手冊，有些用法已經改變** >[danger]**再次提醒，如非必要，在建項目請勿盲目升級。** # 【V1.3.2升級至V1.3.3】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 >[danger]注意：ThinkPHP5.0.24發布了一個安全，建議升級到最新版本。如果不便升級，請直接參考最新版本的Request類的method方法進行手動修復。https://github.com/top-think/framework/commit/4a4b5e64fa4c46f851b4004005bff5f3196de003 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) >[info] 授權用戶可登錄海豚官網后下載授權版補丁，包含新功能。 # 【V1.3.1升級至V1.3.2】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 >[danger]注意：ThinkPHP5.0.23發布了一個安全，建議升級到最新版本。如果不便升級，請參考TP官方文檔，修復方法：https://blog.thinkphp.cn/869075 1.下載安裝補丁下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 執行升級程序。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) **2.數據授權** 如果使用到了數據授權功能，請修改模塊配置文件info.php中的數據授權配置格式，如果沒有用到數據授權功能，請忽略。比如原本cms模塊中的數據授權配置如下 ``` // 授權配置 'access' => [ 'group' => [ "tab_title" => '欄目授權', "table_name" => "cms_column", "primary_key" => "id", "parent_id" => "pid", "node_name" => "name" ], ], ``` 請修改為 ``` // 授權配置 'access' => [ 'group' => [ 'title' => '欄目授權', 'nodes' => [ 'group' => 'column', 'table_name' => 'cms_column', 'primary_key' => 'id', 'parent_id' => 'pid', 'node_name' => 'name', ] ], ], ``` 然后進入后臺，【系統設置】【擴展中心】【模塊管理】，更新cms模塊 ![](https://box.kancloud.cn/5f19f25defb057f5d8b22ae132745458_1346x117.png) 其他模塊的數據授權也類似這樣修改，具體的數據授權配置請參考：[數據授權（1.3.2+）](數據授權.md) **3.清空緩存** 點擊后臺右上角的清空緩存按鈕，或者手動刪除runtime目錄內的所有文件 # 【V1.3.0升級至V1.3.1】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 執行升級程序。 >[info]注意：只能從后臺入口執行升級程序，升級過程中，請注意查看升級說明。如果執行升級過程中，卡主不動，請檢測下是不是PHP5環境，如果是，請打開php.ini,搜索 `;always_populate_raw_post_data = -1;` 將前面的分號去掉，然后重啟php。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.2.1升級至V1.3.0】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。下載補丁包并解壓，將`update`目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 執行升級程序。 >[info]注意：只能從后臺入口執行升級程序補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.2.0升級至V1.2.1】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。下載補丁包并解壓，將update目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 執行升級程序。 >[info]注意：只能從后臺入口執行升級程序補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.1.0升級至V1.2.0】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。下載補丁包并解壓，將update目錄復制到`application`目錄，然后訪問 `http://你的網址/admin.php/update` 執行升級程序。 >[info]注意：只能從后臺入口執行升級程序補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.0.8升級至V1.1.0】 >[danger] 注意！升級前，請務必備份站點和數據庫，避免不必要的損失。 >[danger] 由于此次更新了ThinkPHP核心，導致根目錄下的`composer.lock`文件和`vendor`目錄有變化，如果自己用composer安裝過其他擴展，請注意和自己的`composer.lock`比對，勿直接覆蓋，以免導致某些擴展丟失。由于新版本將框架入口文件移回public目錄，所以升級后，需要將網站運行目錄設置為public。如果是正式項目，請認真考慮是否升級到此版本，避免出現未知問題。建議另外復制項目進行升級測試。 **1. 在數據庫中執行，以下sql語句，注意表前綴是否為dp_，如果不是，請改為自己的表前綴。** ~~~ INSERT INTO `dp_admin_config` VALUES (null, 'system_log', '系統日志', 'system', 'switch', '1', '', '是否開啟系統日志功能', '', '', '', '', '', '0', '', '', '', '', '1512635391', '1512635391', '99', '1'); ~~~ **2. 打開【系統】【系統設置】【數據庫】，設置“數據庫備份根路徑”為“../data/”。** **3. 如果有自定義擴展表單項，需要將除`Builder.php`以外的文件，移動到`public/extend/form/`下** 比如，原來的擴展表單項是這樣的文件結構 ![](https://box.kancloud.cn/9f835ac0e27a2f62e843704ecd7d644b_287x172.jpg) 那么需要將除`Builder.php`以外的其他文件，都移動到public目錄 ![](https://box.kancloud.cn/131025fc159f1771d548168394f55e66_341x152.jpg) **4. 覆蓋補丁** 補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) **5. 刪除無用的文件** 因為將入口文件移動到了public目錄，所以原來的入口文件，及其他就無用了，可以刪除也可以不刪除。 ![](https://box.kancloud.cn/bf8db5a7ccc3660e716050d2e622268c_139x131.jpg) # 【V1.0.7升級至V1.0.8】 >[danger] 升級前，請注意備份站點和數據庫，這是國際慣例，以防不測。此版本主要以修復bug和優化為主，可以無縫升級，但還是強烈建議升級前，先備份站點和數據庫！！！升級后，請清空runtime目錄。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.0.6升級至V1.0.7】 >[danger] 升級前，請注意備份站點和數據庫，這是國際慣例，以防不測。 **1. 在數據庫中執行，以下sql語句，注意表前綴是否為dp_，如果不是，請改為自己的表前綴。** ~~~ INSERT INTO `dp_admin_hook` VALUES (null, 'page_plugin_js', '', '頁面插件js鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'page_plugin_css', '', '頁面插件css鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'signin_sso', '', '單點登錄鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'signout_sso', '', '單點退出鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'user_add', '', '添加用戶鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'user_edit', '', '編輯用戶鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'user_delete', '', '刪除用戶鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'user_enable', '', '啟用用戶鉤子', '1', '1503633591', '1503633591', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'user_disable', '', '禁用用戶鉤子', '1', '1503633591', '1503633591', '1'); ~~~ **2. 然后覆蓋補丁。** >[danger] 注意！！由于此次更新了ThinkPHP核心，導致根目錄下的`composer.lock`文件和vendor目錄有變化，如果自己用composer安裝過其他擴展，請注意和自己的`composer.lock`比對，勿直接覆蓋，以免導致某些擴展丟失。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) **3. 清空`runtime`目錄下的所有緩存文件。** >[danger] 考慮到安全問題，新版不再以明文的方式傳輸表名，如果需要在quickedit、disable、enable等方法獲取表名，可以按下面的方法獲取 ~~~ $table_token = input('param._t'); $table_data = session($table_token); $table = $table_data['table']; // 獲取當前表格所設置的表名 ~~~ # 【V1.0.5升級至V1.0.6】 >[danger] 升級前，請注意備份站點和數據庫，這是國際慣例，以防不測。 1. 在數據庫中執行，以下sql語句，注意表前綴是否為dp_，如果不是，請改為自己的表前綴。 ~~~ INSERT INTO `dp_admin_config` VALUES (null, 'upload_driver', '上傳驅動', 'upload', 'radio', 'local', 'local:本地', '圖片或文件上傳驅動', '', '', '', '', '', '0', '', '', '', '', '1501488567', '1501490821', '100', '1'); INSERT INTO `dp_admin_hook` VALUES (null, 'upload_attachment', '', '附件上傳鉤子', '1', '1501493808', '1501493808', '1'); ALTER TABLE `dp_admin_menu` ADD COLUMN `params` varchar(255) NOT NULL DEFAULT '' COMMENT '參數' AFTER `status`; ~~~ 2. 然后覆蓋補丁即可。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.0.4升級至V1.0.5】 >[danger] 升級前，請注意備份站點和數據庫，這是國際慣例，以防不測。 1. 如果用到`index_url`方法生成前臺url，那么請改為`home_url`來生成。 2. 在數據庫中執行，以下sql語句，注意表前綴是否為dp_，如果不是，請改為自己的表前綴。 ~~~ UPDATE dp_admin_menu SET url_type = 'module_admin' WHERE url_type = 'module'; ~~~ >[danger] **特別注意**，由于此次升級添加了新擴展，composer.json文件有所變化，如果自己用composer安裝過其他擴展，請注意和自己的composer.json比對，勿直接覆蓋，以免導致某些擴展丟失。 3. 然后覆蓋補丁即可。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.0.3升級至V1.0.4】 >[danger] 升級前，請注意備份站點和數據庫，這是國際慣例，以防不測。打開“系統”-“系統功能”-“系統設置”，切換到“系統”選項卡，將【配置類型】的內容替換成以下數據，然后保存。 ~~~ text:單行文本 textarea:多行文本 static:靜態文本 password:密碼 checkbox:復選框 radio:單選按鈕 date:日期 datetime:日期+時間 hidden:隱藏 switch:開關 array:數組 select:下拉框 linkage:普通聯動下拉框 linkages:快速聯動下拉框 image:單張圖片 images:多張圖片 file:單個文件 files:多個文件 ueditor:UEditor 編輯器 wangeditor:wangEditor 編輯器 editormd:markdown 編輯器 ckeditor:ckeditor 編輯器 icon:字體圖標 tags:標簽 number:數字 bmap:百度地圖 colorpicker:取色器 jcrop:圖片裁剪 masked:格式文本 range:范圍 time:時間 ~~~ 然后覆蓋補丁即可。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.0.2升級至V1.0.3】 >[danger] 升級前，請注意備份站點和數據庫，這是國際慣例，以防不測。打開“系統”-“系統功能”-“配置管理”，切換到“系統”選項卡修改“`default_module`”為“`home_default_module`” ![](https://box.kancloud.cn/2a35a893ad9d8b81e975b04c4b2850f6_841x603.png) 然后覆蓋補丁即可。補丁：[http://dolphinphp.com/patch.html](http://dolphinphp.com/patch.html) # 【V1.0.1升級至V1.0.2】 [http://bbs.dolphinphp.com/?/article/22](http://bbs.dolphinphp.com/?/article/22) # 【V1.0.0升級至V1.0.1】 [http://bbs.dolphinphp.com/?/article/15](http://bbs.dolphinphp.com/?/article/15) # 【V1.0公測版2017-01-20升級至V1.0.0正式版】 >[danger]更新前，請注意備份文件和數據庫。 1.執行以下sql語句 >[danger]注意：如果表前綴不是dp_請替換為你的表前綴 ~~~ ALTER TABLE `dp_admin_module` CHANGE `config` `config` TEXT CHARACTER SET utf8 COLLATE utf8_general_ci NULL COMMENT '配置信息'; ALTER TABLE `dp_admin_module` CHANGE `access` `access` TEXT CHARACTER SET utf8 COLLATE utf8_general_ci NULL COMMENT '授權配置'; INSERT INTO `dp_admin_config` VALUES (NULL, 'default_module', '前臺默認模塊', 'system', 'select', 'index', '', '前臺默認訪問的模塊，該模塊必須有Index控制器和index方法', '', '', '', '', '', '0', '', '', '', '', '1486714723', '1486715620', '104', '1'); INSERT INTO `dp_admin_config` VALUES (NULL, 'minify_status', '開啟minify', 'system', 'switch', '0', '', '開啟minify會壓縮合并js、css文件，可以減少資源請求次數，請按實際需求開啟或關閉', '', '', '', '', '', '0', '', '', '', '', '1487035843', '1487035843', '99', '1'); ~~~ 2.覆蓋補丁下載地址：[2017-01-20升級至1.0正式版](http://www.dolphinphp.com/index/index/getpatch/md5/E4C1465078682813904FA4F3DA06E587.html) 本次更新的文件較多，如果沒有修改過框架文件，可直接將補丁覆蓋到框架，如果修改過框架文件，請自行用對比工具查看和修改。如果在插件中用到了模板替換變量`__PLUGINS__`，請將對應的插件資源從`public/static/plugins/`移動到對應的插件目錄下 # 【V1.0公測版2017-01-10升級至2017-01-20】下載補丁：[2017-01-10升級至2017-01-20](http://www.dolphinphp.com/index/index/getpatch/md5/87C65A71CF3292EF978487D5F105D0FE.html) 安裝方法：直接覆蓋到框架根目錄（如果修改過框架文件，則自行比對覆蓋） # 【V1.0公測版2017-01-04升級至2017-01-10】下載補丁：[2017-01-04升級至2017-01-10](http://www.dolphinphp.com/index/index/getpatch/md5/4A33962F03F26604CB24D98160B7B9D8.html) 安裝方法：直接覆蓋到框架根目錄 # 【V1.0公測版2016-12-26升級至2017-01-04】下載補丁：[2016-12-26升級至2017-01-04](http://www.dolphinphp.com/index/index/getpatch/md5/7E7A96DBDA4D82EB13CDAEFBA9534CB4.html) 安裝方法：直接覆蓋到框架根目錄