萬盛學電腦網

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

ThinkPHP 框架入門核心知識完整整理 (MVC、目錄結構、URL 模式、資料庫操作)

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/VApplication/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 較差
PATHINFO1 (預設) /Home/User/login/id/1 最常用,路徑資訊明確,需 Web 伺服器支援 PATH_INFO
REWRITE2 /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.2ThinkPHP 5.0+ThinkPHP 6.0+
PHP 版本需求>= 5.3>= 5.6>= 7.1
命名空間部分支援全面 PSR-4全面 PSR-4
控制器基類ControllerControllerBaseController / Controller
模型基類ModelModelModel (基於 think-orm)
路由系統簡單規則完整路由完整路由 + 註解
依賴注入無容器支援完整 PSR-11 容器
中介軟體BehaviorMiddlewareMiddleware (PSR-15)
安裝方式手動/壓縮包ComposerComposer

結語

ThinkPHP 以「簡單、快速、實用」著稱,MVC 分層清晰、內建豐富功能 (快取、驗證、日誌、模板引擎等),學習曲線平緩。掌握核心目錄結構、URL 模式、模型操作與模板語法,即可快速上手開發。新專案建議直接使用 ThinkPHP 6.0+ 或 8.0,享受現代 PHP 特性與長期支援。

copyright © 萬盛學電腦網 all rights reserved