萬盛學電腦網

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

ThinkPHP 3.2 安裝配置與入門實戰:從目錄結構到 MVC 實作

ThinkPHP 作為國產 MVC 框架代表,早期模仿 Java Struts 設計(單一入口、Action 控制器)。3.2 版本引入命名空間、目錄重組等重大變更。本文記錄安裝配置要點、目錄結構解析、URL 訪問規則與首個 Action/View 實作,助你快速上手。

一、核心設計理念

  • 單一入口:所有請求經 index.php(或自定義入口)進入
  • MVC 分層:Model(模型)、View(視圖)、Controller/Action(控制器)
  • 約定優於配置:目錄命名、類名、方法名遵循規範即可自動映射

二、安裝與目錄生成

1. 建立入口檔案

在框架根目錄下建立 admin.php(名稱可自訂):

<?php
define('APP_NAME', '');           // 專案名稱,空則不產生前綴目錄
define('APP_PATH', './admin/');   // 應用目錄相對路徑
define('APP_DEBUG', true);        // 開啟除錯模式:強制編譯、不緩存
require '../ThinkPHP/ThinkPHP.php'; // 載入框架核心入口
?>

2. 自動生成的目錄結構

admin/
├── Common/      # 公共函數庫
├── Conf/        # 配置檔(資料庫、快取等)
├── Lang/        # 語言包(國際化)
├── Lib/         # 核心業務邏輯
│   ├── Action/  # 控制器(舊版稱 Action,3.2.3+ 改為 Controller)
│   └── Model/   # 模型
├── Runtime/     # 執行期緩存、日誌
└── Tpl/         # 模板檔(舊版 Tpl,3.2.3+ 改為 View)

三、URL 訪問規則詳解

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 方法

四、撰寫第一個 Action 與 Template

1. 控制器:Lib/Action/ShowAction.class.php

<?php
class ShowAction extends Action {
    public function add() {
        // 自動載入 Tpl/Show/cc.html,若無則載入 add.html,皆無則報錯
        $this->display('cc');
    }
}
?>

2. 模板:Tpl/Show/cc.html

<html>
<head><title>ThinkPHP Demo</title></head>
<body><h1>Hello ThinkPHP!</h1></body>
</html>

五、常見坑點提醒

  1. 類名大小寫:Linux 區分大小寫,showAction 會 404,必須 ShowAction
  2. 模板路徑:display('cc') 對應 Tpl/當前控制器名/cc.html
  3. 除錯模式:開發階段務必開啟 APP_DEBUG,否則修改程式碼不生效
  4. URL 重寫:生產環境配置 Apache/Nginx rewrite 規則隱藏 admin.php

六、版本演進提示

3.2.3 版本將 Action 更名為 Controller、Tpl 改為 View,更貼近標準 MVC 命名。舊專案可透過配置 DEFAULT_C_LAYER => 'Action' 保持相容。

copyright © 萬盛學電腦網 all rights reserved