ThinkPHP 簡介
ThinkPHP 是國內最流行的 PHP 開發框架之一,創立於 2006 年,遵循 Apache 2 開源協議。特點為輕量級、快速、簡單、面向物件,專為敏捷 Web 應用與企業級開發設計。經過多年社群迭代,已發展至 ThinkPHP 8.0 (最新版),但在 3.2/5.0/6.0 版本間存在較大差異。本文以 ThinkPHP 3.2/5.0 經典架構 為核心整理基礎知識,適合初學者建立完整框架觀念。
MVC 架構在 ThinkPHP 中的對應
| 層級 | 代稱 | 職責 | 對應目錄 (TP 3.2) | 對應目錄 (TP 5.0+) |
| Model (M) | 模型 | 資料邏輯、業務規則、資料庫操作 | Application/Home/Model/ | app/model/ |
| View (V) | 視圖 | 頁面模板渲染、前端呈現 | Application/Home/View/ | app/view/ |
| Controller (C) | 控制器 | 請求分發、流程控制、協調 M/V | Application/Home/Controller/ | app/controller/ |
框架核心目錄結構 (ThinkPHP 3.2 為例)
ThinkPHP/ # 框架核心目錄
├── ThinkPHP.php # 框架入口檔案
├── Common/ # 框架公共函數
├── Conf/ # 框架核心配置
├── Extend/ # 框架擴充套件
├── Lang/ # 核心語言包
├── Lib/ # 核心類別庫
│ ├── Behavior/ # 核心行為擴充
│ ├── Core/ # 核心基礎類別
│ ├── Driver/ # 內建驅動
│ │ ├── Cache/ # 快取驅動
│ │ ├── Db/ # 資料庫驅動
│ │ ├── TagLib/ # 標籤庫驅動
│ │ └── Template/ # 模板引擎驅動
│ └── Template/ # 內建模板引擎
└── Tpl/ # 系統預設模板
應用專案目錄結構 (模組化設計)
Application/ # 應用目錄 (可多模組)
├── Home/ # 前台模組
│ ├── Common/ # 模組公共函數/配置
│ ├── Conf/ # 模組配置 (config.php, route.php 等)
│ ├── Lang/ # 模組語言包
│ ├── Lib/ # 模組類別庫
│ │ ├── Action/ # 控制器 (TP3.2 命名)
│ │ ├── Model/ # 模型
│ │ ├── Behavior/ # 行為擴充
│ │ └── Widget/ # 元件
│ ├── Runtime/ # 運行時目錄 (需寫入權限)
│ │ ├── Cache/ # 模板快取
│ │ ├── Data/ # 資料快取
│ │ ├── Logs/ # 日誌
│ │ └── Temp/ # 暫存
│ └── Tpl/ # 模組模板
├── Admin/ # 後台模組 (同結構)
└── Common/ # 跨模組共用 (常用函數、基類等)
URL 存取模式 (四種模式對照)
ThinkPHP 支援多種 URL 模式,透過 URL_MODEL 設定 (TP3.2) 或 url_route_on + 路由規則 (TP5+)。
| 模式 | 常數值 | URL 範例 | 特點 |
| 普通模式 | 0 |
?m=Home&c=User&a=login&id=1 |
相容性最好,無需重寫支援,SEO 較差 |
| PATHINFO | 1 (預設) |
/Home/User/login/id/1 |
最常用,路徑資訊明確,需 Web 伺服器支援 PATH_INFO |
| REWRITE | 2 |
/Home/User/login/id/1 (隱藏 index.php) |
最美觀,需 Apache mod_rewrite / Nginx rewrite 規則 |
| 相容模式 | 3 |
?s=/Home/User/login/id/1 |
不支援 PATH_INFO 環境的備選方案 |
Nginx REWRITE 規則範例 (TP 3.2/5.0 通用)
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
break;
}
}
控制器與模板輸出 (TP 3.2 風格)
控制器基礎
<?php
namespace Home\Controller;
use Think\Controller;
class UserController extends Controller
{
public function index()
{
// 1. 直接輸出 (不推薦,破壞 MVC 分離)
echo 'Hello World';
// 2. 分配變數給模板
$this->assign('name', 'ThinkPHP');
$this->assign('users', [['id'=>1,'name'=>'Tom'], ['id'=>2,'name'=>'Jerry']]);
// 3. 渲染模板 (預設對應 View/User/index.html)
$this->display();
// 4. 指定其他模板
// $this->display('User:profile'); // 跨控制器模板
// $this->display('./Public/header'); // 絕對路徑
}
}
模板語法重點
- 變數輸出:
{$name}、{$user.name}、{$users.0.name}
- 迴圈輸出:
<volist name="users" id="vo">{$vo.name}</volist>
- 條件判斷:
<if condition="$user.status eq 1">正常<else/>停用</if>
- 模板繼承/區塊:
<block name="content"></block> (TP3.2 需開啟 TMPL_LAYOUT_ITEM)
- 修改定界符:
'TMPL_L_DELIM' => '<{', 'TMPL_R_DELIM' => '}>' (避免與 Vue/JS 模板衝突)
資料庫操作 (Model 層核心)
配置資料庫 (Conf/config.php)
return [
'DB_TYPE' => 'mysql',
'DB_HOST' => 'localhost',
'DB_NAME' => 'thinkphp',
'DB_USER' => 'root',
'DB_PWD' => 'password',
'DB_PORT' => '3306',
'DB_PREFIX' => 'tp_', // 表前綴
'DB_CHARSET'=> 'utf8mb4', // 編碼
// DSN 方式 (優先級較高)
// 'DB_DSN' => 'mysql://root:password@localhost:3306/thinkphp?charset=utf8mb4',
];
模型實例化三種方式
// 1. 完整實例化 (需對應 Model 類別)
$model = new \Home\Model\UserModel();
// 2. M() 方法 (推薦,自動對應 tp_user 表)
$model = M('User'); // 等同 new Model('User')
// 3. D() 方法 (需定義 Model 類別,支援自訂邏輯)
$model = D('User'); // 等同 new \Home\Model\UserModel()
CURD 核心操作
| 操作 | 方法 | 範例 | 回傳值 |
| 新增 (Create) | add() | $model->data($data)->add() | 新增記錄自增 ID (成功) / false |
| 讀取 (Read) | select() | $model->where('status=1')->select() | 二維陣列 / 空陣列 |
| 單筆讀取 | find() | $model->find(1) | 一維陣列 / null |
| 欄位值 | getField() | $model->where('id=5')->getField('name') | 字串 / 陣列 / null |
| 更新 (Update) | save() | $model->data($data)->where('id=1')->save() | 影響筆數 / false |
| 刪除 (Delete) | delete() | $model->delete(1) 或 where()->delete() | 影響筆數 / false |
查詢語言進階 (WHERE 條件)
// 1. 字串條件
$model->where("status=1 AND name LIKE '%think%'")->select();
// 2. 陣列條件 (預設 AND)
$model->where(['status'=>1, 'name'=>'think'])->select();
// 3. OR 條件
$model->where(['status'=>1, 'name'=>'think', '_logic'=>'OR'])->select();
// 4. 表達式查詢
$model->where('id', '>', 10)->select(); // GT
$model->where('id', '>=', 10)->select(); // EGT
$model->where('id', '<', 10)->select(); // LT
$model->where('id', '<=', 10)->select(); // ELT
$model->where('id', '<>', 10)->select(); // NEQ
$model->where('name', 'LIKE', '%think%')->select(); // LIKE
$model->where('name', 'NOT LIKE', '%think%')->select();
// 5. 區間/集合
$model->where('id', 'BETWEEN', [5, 10])->select();
$model->where('id', 'NOT BETWEEN', [5, 10])->select();
$model->where('id', 'IN', [1,3,5])->select();
$model->where('id', 'NOT IN', [1,3,5])->select();
// 6. 複合條件 (多條件同欄位)
$model->where('name', ['LIKE', ['%a%', '%b%']], 'OR')->select();
// 7. 區間查詢 (Range)
$model->where('id', ['>', 5, '<', 10])->select(); // 5 < id < 10
除錯與追蹤 (Page Trace)
// 入口檔案 index.php 開啟除錯模式
define('APP_DEBUG', true);
// 配置開啟頁面 Trace
'SHOW_PAGE_TRACE' => true, // 需搭配 $this->display() 才顯示
// Trace 面板包含:執行時間、記憶體、查詢 SQL、變數、檔案載入、錯誤資訊等
版本差異快速對照 (重點)
| 特性 | ThinkPHP 3.2 | ThinkPHP 5.0+ | ThinkPHP 6.0+ |
| PHP 版本需求 | >= 5.3 | >= 5.6 | >= 7.1 |
| 命名空間 | 部分支援 | 全面 PSR-4 | 全面 PSR-4 |
| 控制器基類 | Controller | Controller | BaseController / Controller |
| 模型基類 | Model | Model | Model (基於 think-orm) |
| 路由系統 | 簡單規則 | 完整路由 | 完整路由 + 註解 |
| 依賴注入 | 無 | 容器支援 | 完整 PSR-11 容器 |
| 中介軟體 | Behavior | Middleware | Middleware (PSR-15) |
| 安裝方式 | 手動/壓縮包 | Composer | Composer |
結語
ThinkPHP 以「簡單、快速、實用」著稱,MVC 分層清晰、內建豐富功能 (快取、驗證、日誌、模板引擎等),學習曲線平緩。掌握核心目錄結構、URL 模式、模型操作與模板語法,即可快速上手開發。新專案建議直接使用 ThinkPHP 6.0+ 或 8.0,享受現代 PHP 特性與長期支援。