ThinkPHP 作為國產 MVC 框架代表,早期模仿 Java Struts 設計(單一入口、Action 控制器)。3.2 版本引入命名空間、目錄重組等重大變更。本文記錄安裝配置要點、目錄結構解析、URL 訪問規則與首個 Action/View 實作,助你快速上手。
index.php(或自定義入口)進入在框架根目錄下建立 admin.php(名稱可自訂):
<?php
define('APP_NAME', ''); // 專案名稱,空則不產生前綴目錄
define('APP_PATH', './admin/'); // 應用目錄相對路徑
define('APP_DEBUG', true); // 開啟除錯模式:強制編譯、不緩存
require '../ThinkPHP/ThinkPHP.php'; // 載入框架核心入口
?>
admin/
├── Common/ # 公共函數庫
├── Conf/ # 配置檔(資料庫、快取等)
├── Lang/ # 語言包(國際化)
├── Lib/ # 核心業務邏輯
│ ├── Action/ # 控制器(舊版稱 Action,3.2.3+ 改為 Controller)
│ └── Model/ # 模型
├── Runtime/ # 執行期緩存、日誌
└── Tpl/ # 模板檔(舊版 Tpl,3.2.3+ 改為 View)
ThinkPHP 採用 模組/控制器/方法 的 PATHINFO 模式:
| URL 形式 | 範例 | 對應執行邏輯 |
|---|---|---|
| 普通參數模式 | localhost/thinkphp/admin.php?m=Show&a=add | 入口 admin.php → ShowAction 類 → add() 方法 |
| PATHINFO 模式 | localhost/thinkphp/admin.php/Show/add | 同上,更優雅、利於 SEO |
關鍵規則:
ShowAction),小寫會找不到m 對應 Lib/Action/ 下的類名(去掉 Action 後綴)a 對應類中的 public 方法Lib/Action/ShowAction.class.php<?php
class ShowAction extends Action {
public function add() {
// 自動載入 Tpl/Show/cc.html,若無則載入 add.html,皆無則報錯
$this->display('cc');
}
}
?>
Tpl/Show/cc.html<html>
<head><title>ThinkPHP Demo</title></head>
<body><h1>Hello ThinkPHP!</h1></body>
</html>
showAction 會 404,必須 ShowActiondisplay('cc') 對應 Tpl/當前控制器名/cc.htmlAPP_DEBUG,否則修改程式碼不生效admin.php3.2.3 版本將 Action 更名為 Controller、Tpl 改為 View,更貼近標準 MVC 命名。舊專案可透過配置 DEFAULT_C_LAYER => 'Action' 保持相容。