萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

ThinkPHP 3.2 重大變更完整遷移指南:目錄、命名空間、配置、方法全解析

ThinkPHP 3.2 並非小版本迭代,而是架構層面的大重構:要求 PHP 5.3+、引入命名空間、目錄重組、棄用大量配置常數與方法。若從 3.1 升級,絕非單純覆蓋檔案,需系統性遷移。本文彙整官方文檔與實戰經驗,提供完整遷移清單。

一、環境需求提升

  • PHP 版本:3.1 支援 5.2+,3.2 強制要求 5.3+(命名空間、晚靜態綁定等特性依賴)

二、目錄結構重組

3.1 舊路徑3.2 新路徑說明
App/Application/應用根目錄更名
App/Common/common.phpApplication/Home/Common/function.php公共函數檔
App/Conf/Config.phpApplication/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'

三、.htaccess Rewrite 規則必須更新

<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;

分層擴展(如 Event、Service)

namespace Home\Event;
use Think\Controller;

namespace Home\Service;
use Think\Model;

六、方法調整:I() 方法統一參數獲取

棄用方法替代方法
_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_NAME3.2 無需定義
__GROUP__改用 __MODULE__
GROUP_NAME改用 MODULE_NAME
MODE_NAME模式擴展已棄用

八、遷移檢查清單

  1. 確認伺服器 PHP ≥ 5.3
  2. 整個專案目錄遷移至 Application/Home/ 對應位置
  3. 所有 Controller/Model 檔案首行加入 namespace
  4. 配置檔參數對照表修正
  5. 替換所有 _get/_post 等為 I()
  6. 更新 .htaccess rewrite 規則
  7. 測試核心流程:路由、模型、視圖渲染、Session、快取

遷移過程中遇到未文檔化問題,請直接查閱官方完整手冊或原始碼。

copyright © 萬盛學電腦網 all rights reserved