ThinkPHP 專案目錄結構自訂實戰：簡化預設架構

ThinkPHP 預設生成的目錄結構層級較深，對習慣扁平化結構（如 DedeCMS）的開發者不夠直觀。本文示範如何透過自訂入口檔案，重新定義專案目錄常數，達到簡化結構的目的——無需修改框架核心原始碼。

自訂入口檔案 index.php

<?php
$root = dirname(__FILE__);
$root = str_replace('\\', '/', $root);

// 核心路徑常數重新定義
define('__ROOT__', $root);                    // 網站根目錄
define('LIB_PATH', __ROOT__ . '/libs/');      // 類庫目錄
define('CONF_PATH', __ROOT__ . '/config/');   // 設定檔目錄
define('LANG_PATH', __ROOT__ . '/lang/');     // 語言包目錄
define('TMPL_PATH', __ROOT__ . '/templates/');// 模板目錄
define('HTML_PATH', __ROOT__ . '/a/');        // 靜態快取目錄
define('RUNTIME_PATH', __ROOT__ . '/cache/'); // 執行期快取根目錄

// 子快取目錄
define('LOG_PATH', RUNTIME_PATH . '/log/');
define('TEMP_PATH', RUNTIME_PATH . '/temp/');
define('DATA_PATH', RUNTIME_PATH . '/data/');
define('CACHE_PATH', RUNTIME_PATH . '/cache/');

define('APP_DEBUG', true); // 開啟除錯模式

// 載入框架核心
require_once 'core/ThinkPHP.php';

產生的目錄結構

• 將框架核心資料夾 ThinkPHP 重命名為 core，放在網站根目錄。
• 應用層目錄（libs、config、templates 等）直接置於根目錄，層級扁平。
• 所有快取、日誌、資料檔案統一歸口 cache/ 管理。

優缺點分析

適用場景

• 中小型專案、快速原型開發。
• 偏好扁平化目錄的團隊。
• 不想深度綁定框架預設結構的專案。

提醒：初學者建議先熟悉預設結構運作機制，再嘗試自訂，避免路徑解析錯誤難以排查。