ThinkPHP 3.2 並非小版本迭代,而是架構層面的大重構:要求 PHP 5.3+、引入命名空間、目錄重組、棄用大量配置常數與方法。若從 3.1 升級,絕非單純覆蓋檔案,需系統性遷移。本文彙整官方文檔與實戰經驗,提供完整遷移清單。
| 3.1 舊路徑 | 3.2 新路徑 | 說明 |
|---|---|---|
App/ | Application/ | 應用根目錄更名 |
App/Common/common.php | Application/Home/Common/function.php | 公共函數檔 |
App/Conf/Config.php | Application/Home/Conf/config.php | 配置檔(注意大小寫) |
App/Lib/Action/ | Application/Home/Controller/ | 控制器目錄更名 |
App/Lib/Model/ | Application/Home/Model/ | 模型目錄 |
App/Tpl/ | Application/Home/View/ | 視圖目錄更名 |
關鍵點:新增 Home 模組目錄,所有業務碼遷移至此。若保留舊 Action 命名,需在 Application/Common/config.php 設定:
'DEFAULT_C_LAYER' => 'Action',
'MODULE_ALLOW_LIST' => array('Home','Admin',...),
'DEFAULT_MODULE' => 'Home'
<IfModule mod_rewrite.c>
Options +FollowSymlinks
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/home/$1 [QSA,PT,L]
</IfModule>
否則會出現「模組找不到」錯誤。
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
DB_DEBUG, DB_LITE 等資料庫相關新參數(詳見 3.2.3 資料庫配置文檔)
所有 Application/Home/Controller/、Model/ 下的類檔案首行必須宣告命名空間:
namespace Home\Controller;
use Think\Controller;
namespace Home\Model;
use Think\Model;
namespace Home\Event;
use Think\Controller;
namespace Home\Service;
use Think\Model;
| 棄用方法 | 替代方法 |
|---|---|
_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') |
| 棄用常數 | 替代方案 |
|---|---|
APP_NAME | 3.2 無需定義 |
__GROUP__ | 改用 __MODULE__ |
GROUP_NAME | 改用 MODULE_NAME |
MODE_NAME | 模式擴展已棄用 |
Application/Home/ 對應位置_get/_post 等為 I()遷移過程中遇到未文檔化問題,請直接查閱官方完整手冊或原始碼。