本章旨在幫助使用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，如果顯示  則準備工作已經完成，下面開始進行應用目錄的調整工作。 ## 應用目錄調整 應用目錄的調整分三種不同的情況：**未分組/普通分組/獨立分組**，請根據自己的情況選擇目錄調整的方式。 ### 未分組 如果你的項目未進行任何分組，請按照如下的方式調整目錄結構： 刪除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 模版文件目錄 ~~~ ### 普通分組 如果你的項目采用了普通分組，則按照下面的方式進行目錄調整（以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分組進行調整即可。 ### 獨立分組 如果采用的是獨立分組，公共函數目錄作如下調整，類似于： ~~~ 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和原來的項目目錄。 **希望您的項目能夠升級順利！**