升級指導 · 文檔規范示例

# 升級指導 [上一頁](# "上一頁")[下一頁](# "下一頁") 本章旨在幫助使用3.1版本的用戶更方便的升級到3.2版本，給出了升級步驟和建議。 ### 升級須知如果從3.1版本升級到3.2版本，需要注意如下的升級須知并按照升級指導的操作步驟進行。 - 3.2版本要求PHP5.3.0以上，如果環境低于該版本，將無法升級； - 本升級指導用于指導開發人員從3.1版本升級到3.2版本； - 如果你的項目對框架核心進行過較大的改動的話不建議升級； - 本指導手冊不確保你的項目順利升級，不對因升級帶來的任何后果負責； - 升級項目之前請做好各項備份工作。 ### 準備工作 - 從官網或者github下載最新版本的ThinkPHP3.2； - 把下載的ThinkPHP3.2解壓縮，得到Application、Public和ThinkPHP目錄，以及一個入口文件index.php； - 備份你的項目文件（包括ThinkPHP核心目錄）到安全的位置； - 刪除項目的Runtime目錄； - 把原來的ThinkPHP系統目錄更名為ThinkPHP_old； - 把原來的index.php入口文件更名為index_old.php； - 如果原來的項目目錄為Application更名為App； - 把解壓后的Application、ThinkPHP目錄，以及index.php放入你的網站目錄； - 運行新的入口文件index.php，如果顯示 ![](https://box.kancloud.cn/2015-08-20_55d56f797f670.png) 則準備工作已經完成，下面開始進行應用目錄的調整工作。 ### 應用目錄調整應用目錄的調整分三種不同的情況：**未分組/普通分組/獨立分組**，請根據自己的情況選擇目錄調整的方式。 ### 1、未分組如果你的項目未進行任何分組，請按照如下的方式調整目錄結構：刪除Application/Common目錄，在你的原有項目目錄（假設為App）下面的Common、Conf和Lang目錄移動到Application/Home目錄下面，并把其中的Common/common.php文件改名為function.php，移動前后的位置類似于： ~~~ App/Common/common.php => Application/Home/Common/function.php App/Common/extend.php => Application/Home/Common/extend.php（假設存在定義的話） App/Conf/Config.php => Application/Home/Conf/config.php App/Lang/zh-cn/common.php => Application/Home/Lang/zh-cn.php（假設存在的話） ~~~ 把項目目錄下面的Lib目錄下面的所有子目錄移動到Application/Home目錄下面，類似于： ~~~ App/Lib/Action => Application/Home/Action App/Lib/Model => Application/Home/Model ~~~ 把項目目錄下面的Tpl目錄移動到Application/Home目錄下面，并更名為View，類似于： ~~~ App/Tpl => Application/Home/View ~~~ 調整后的目錄結構類似于： ~~~ Application ├─Home │ ├─Conf 配置文件目錄 │ ├─Common 公共函數目錄 │ ├─Action 控制器目錄 │ ├─Model 模型目錄 │ └─View 模版文件目錄 ~~~ ### 2、普通分組如果你的項目采用了普通分組，則按照下面的方式進行目錄調整（以Home分組為例，其他分組參考調整）：項目公共函數目錄下面的目錄和文件作如下調整，類似于： ~~~ App/Common/common.php => Application/Common/Common/function.php App/Common/Home/function.php => Application/Home/Common/function.php ~~~ 項目目錄下面的Conf目錄如如下調整，類似于： ~~~ App/Conf/Config.php => Application/Common/Conf/config.php App/Conf/Home/config.php => Application/Home/Conf/config.php ~~~ 如果采用了語言包功能，目錄如如下調整： ~~~ App/Lang/zh-cn/common.php => Application/Common/Lang/zh-cn.php App/Lang/zh-cn/Home/lang.php => Application/Home/Lang/zh-cn.php ~~~ 控制器目錄調整如下，類似于： ~~~ App/Lib/Action/Home => Application/Home/Action App/Lib/Action/Admin => Application/Admin/Action ~~~ 模型目錄調整如下，類似于： ~~~ App/Lib/Model => Application/Common/Model App/Lib/Model/Home => Application/Home/Model（如果有定義） ~~~ 模版目錄調整如下，類似于： ~~~ App/Tpl/Home => Application/Home/View ~~~ 調整后的目錄結構如下： ~~~ Application ├─Common 應用公共模塊 │ ├─Common 應用公共函數目錄 │ └─Conf 應用公共配置文件目錄 ├─Home Home模塊 │ ├─Action 模塊控制器目錄 │ ├─Common 模塊函數公共目錄 │ ├─Conf 模塊配置文件目錄 │ ├─Lang 模塊語言包目錄 │ ├─Model 模塊模型目錄 │ └─View 模塊視圖文件目錄 ~~~ > 其他分組參考Home分組進行調整即可。 ### 3、獨立分組如果采用的是獨立分組，公共函數目錄作如下調整，類似于： ~~~ App/Common/common.php => Application/Common/Common/function.php ~~~ 把項目目錄下面的Conf、Lang移動到Application/Common目錄下面，類似于： ~~~ App/Conf/Config.php => Application/Common/Conf/config.php App/Lang/zh-cn/common.php => Application/Common/Lang/zh-cn.php ~~~ 把獨立分組目錄（假設你的獨立分組目錄為App/Modules）下面的子目錄都移動到原來的項目目錄下面，類似于： ~~~ App/Modules/Home => Application/Home ~~~ 并且把Home目錄下面的Tpl目錄更改為View。調整后的目錄結構如下： ~~~ Application ├─Common 應用公共模塊 │ ├─Common 應用公共函數目錄 │ └─Conf 應用公共配置文件目錄 ├─Home Home模塊 │ ├─Action 模塊控制器目錄 │ ├─Common 模塊函數公共目錄 │ ├─Conf 模塊配置文件目錄 │ ├─Lang 模塊語言包目錄 │ ├─Model 模塊模型目錄 │ └─View 模塊視圖文件目錄 ~~~ > 其他分組參考Home分組進行調整即可。 ### 配置調整編輯 `Application/Common/config.php`（沒有則創建一個新的文件），添加下面的配置參數： ~~~ 'DEFAULT_C_LAYER' => 'Action', // 默認的控制器層名稱 'MODULE_ALLOW_LIST' => array('Home','Admin',...)， // 配置你原來的分組列表 'DEFAULT_MODULE' => 'Home'， // 配置你原來的默認分組 ~~~ 未分組的情況下，再添加如下配置參數： ~~~ 'MULTI_MODULE' => false, // 單模塊訪問 'DEFAULT_MODULE' => 'Home'， // 默認訪問模塊 ~~~ 數據庫連接配置參數DB_HOST如果原來配置的是localhost或者域名，請修改為ip地址，否則會導致數據庫連接緩慢（這是PHP5.3的機制問題非TP問題），例如之前如果是配置的： ~~~ 'DB_HOST'=>'localhost' ~~~ 建議改為： ~~~ 'DB_HOST'=>'127.0.0.1' ~~~ 原來的配置參數中廢棄的參數包括（增補中）： ~~~ APP_GROUP_LIST APP_GROUP_MODE APP_AUTOLOAD_PATH APP_TAGS_ON APP_GROUP_PATH DEFAULT_APP DEFAULT_GROUP VAR_GROUP LOG_DEST LOG_EXTRA ~~~ 調整的配置參數包括： ~~~ DEFAULT_MODULE => DEFAULT_CONTROLLER ~~~ ### 別名定義調整如果你在項目中定義了自己的別名定義文件，需要在別名定義中使用命名空間，例如： ~~~ 'Think\Page' => CORE_PATH.'Page'.EXT, 'Think\Auth' => CORE_PATH.'Auth'.EXT, ~~~ ### 行為定義調整如果在項目中自定義了行為定義文件，那么需要修改行為定義為命名空間方式，例如： ~~~ 'app_begin'=>array('Behavior\Cron','Behavior\BrowserCheck'), ~~~ ### 路由定義調整 ##### 如果你的項目使用了路由功能，請參考下面的建議進行調整。 3.2版本的路由定義是針對模塊的，所以路由定義需要放到模塊配置文件中，把`Application/Common/config.php` 中的路由定義相關的配置參數`URL_ROUTER_ON`和`URL_ROUTE_RULES`移動到相關模塊的配置文件中并作適當的調整。 > 新版中路由定義規則中不需要添加模塊名，如果要在URL中隱藏模塊名請參考[模塊部署](http://document.thinkphp.cn/manual_3_2/module_deploy.html)章節內容。 ### 命名空間調整把項目的Application/Home/Action目錄下面的所有文件，頭部添加如下代碼（必須是除注釋以外的第一行）： ~~~ namespace Home\Action; use Think\Action; ~~~ 如果你的項目使用了控制器分層的話，需要對每個分層的類庫文件添加類似的代碼，例如有定義Event分層的話，需要在頭部添加： ~~~ namespace Home\Event; use Think\Action; ~~~ 把項目的Application/Home/Model目錄下面的所有文件，頭部添加如下代碼（必須是除注釋以為的第一行）： ~~~ namespace Home\Model; use Think\Model; ~~~ 如果你的項目使用了模型分層的話，需要對每個分層的類庫文件添加類似的代碼，例如如果你有Service分層，需要在頭部添加： ~~~ namespace Home\Service; use Think\Model; ~~~ 對類庫中的代碼實現中實例化對象（包括系統內置類和自定義類）的部分調整為命名空間調用的方式，例如： ~~~ new Page(...) => new \Think\Page(...) new Pdo(...) => new \Pdo(...) new UserModel(...) => new \Home\Model\UserModel(...) ~~~ > 用ThinkPHP內置的A/D/M方法實例化的對象代碼無需調整。如果你升級的版本是3.2.1版本，應用類庫的命名空間可以無需定義，但調用系統核心類庫的時候仍然需要使用命名空間的方式。在3.2.1版本中，可以在應用配置文件中設置： ~~~ 'APP_USE_NAMESPACE' => false, // 關閉應用的命名空間定義 'APP_AUTOLOAD_LAYER' => 'Action,Model', // 模塊自動加載的類庫后綴 ~~~ 設置后，應用類庫無需再使用命名空間定義，只需要改成： ~~~ class UserAction extends Think\Action{ } class UserModel extends Think\Model{ } ~~~ ### 模型調整如果在模型類的自動驗證或者自動完成定義中使用了下面的常量，需要進行調整： | 原來方式 | 新版方式 | |-----|-----| | MODEL_INSERT | self::MODEL_INSERT | | MODEL_UPDATE | self::MODEL_UPDATE | | MODEL_BOTH | self::MODEL_BOTH | | MUST_VALIDATE | self::MUST_VALIDATE | | EXISTS_VALIDATE | self::EXISTS_VALIDATE | | VALUE_VALIDATE | self::VALUE_VALIDATE | ### 函數調整原來的`halt`函數和`_404`函數已經廢除，`ThrowException`也不建議使用，統一使用E函數替代。如果你之前的項目定義了`common.php`函數文件，需要并入`Common\function.php`函數文件中。 ### 方法調整控制器類Think\Controller或者Think\Action的下列方法已經廢除： | 廢除方法 | 替代方法 | |-----|-----| | _get('id') | I('get.id') | | _post('id') | I('post.id') | | _put('id') | I('put.id') | | _param('id') | I('id') | | _request('id') | I('request.id') | | _cookie('id') | I('cookie.id') | | _server('id') | I('server.id') | | _globals('id') | I('globals.id') | ### 常量調整下列常量已經廢除： ~~~ APP_NAME // 3.2版本中無需再定義該常量 __GROUP__ // 3.2版本中可以用__MODULE__ 表示模塊的URL地址 GROUP_NAME // 3.2版本中可以用 MODULE_NAME 獲取當前模塊名 MODE_NAME // 3.2版本中模式擴展已經廢棄，參考下面的模式調整部分 ~~~ ### 模式調整如果你使用了ThinkPHP的模式擴展，那么抱歉地通知您，原來的模式擴展已經廢棄，命令行模式不需要單獨開發，新版框架可以直接切換到命令行模式訪問。如果使用了PHPRPC或者REST模式的話，請參考專題中的[RPC](http://document.thinkphp.cn/manual_3_2/rpc.html)和[RESTFul](http://document.thinkphp.cn/manual_3_2/restful.html)部分修改。如果你使用了SAE引擎擴展的話，新版在標注模式下面可以直接部署到SAE環境，無需更改。參考[SAE部分](http://document.thinkphp.cn/manual_3_2/sae.html)說明。下面的模式暫時不提供支持： ~~~ Lite Thin Amf ~~~ ### 自定義驅動調整如果你在項目中自定義了相關驅動，包括數據庫、標簽庫等，那么請參考[驅動擴展](http://document.thinkphp.cn/manual_3_2/driver_extend.html)部分進行調整。 ### 模板調整默認的模板替換行為只支持下列替換規則： ~~~ '__ROOT__' => __ROOT__, // 當前網站地址 '__APP__' => __APP__, // 當前應用地址 '__MODULE__' => __MODULE__, '__ACTION__' => __ACTION__, // 當前操作地址 '__SELF__' => __SELF__, // 當前頁面地址 '__CONTROLLER__'=> __CONTROLLER__, '__URL__' => __CONTROLLER__, '__PUBLIC__' => __ROOT__.'/Public',// 站點公共目錄 ~~~ 對于廢除的替換規則你可以在模塊的配置文件中自行添加，例如： ~~~ 'TMPL_PARSE_STRING'=>array( '../Public'=> MODULE_PATH.'View/Public/', '__TMPL__' => MODULE_PATH.'View/default/' ) ~~~ ### 入口文件調整如果你的原來項目的入口文件中（之前備份的index_old.php）還有其他代碼，請調整合并到新的入口文件中，然后建議你開啟調試模式后運行新的入口文件，如果仍然有錯誤發生，請根據錯誤提示進行下一步的調整或者到官網討論區給我們反饋。升級成功后記得刪除ThinkPHP_old和原來的項目目錄。 **希望您的項目能夠升級順利！** [上一頁](# "上一頁")[下一頁](# "下一頁")