ThinkPHP 入口文件配置深度解析：常量定義、路徑映射與調試模式

入口文件使命

ThinkPHP 單一入口模式下，index.php 是整個應用的啟動器，負責定義核心路徑常量、載入框架核心、啟動應用。正確配置關係到部署靈活性與安全性。

核心常量詳細說明

標準入口文件範本

<?php
// +----------------------------------------------------------------------
// | ThinkPHP 入口文件
// +----------------------------------------------------------------------

// 1. 定義應用目錄（相對於入口文件位置）
define('APP_PATH', __DIR__ . '/../application/');

// 2. 開發環境啟用調試（生產環境務必註釋或設為 false）
// 可通過環境變量控制：getenv('APP_DEBUG') ?: false
define('APP_DEBUG', true);

// 3. 綁定模組（可選，單模組專案無需設定）
// define('BIND_MODULE', 'Home');

// 4. 載入框架引導文件
require __DIR__ . '/../thinkphp/start.php';

// 5. 執行應用（ThinkPHP 5/6 風格）
// ThinkPHP 3.x 為：require THINK_PATH.'ThinkPHP.php'; App::run();

調試模式深度影響

開啟 APP_DEBUG = true 後：

• 模板引擎：每次請求重新編譯模板，即時生效
• 日誌記錄：記錄 SQL、錯誤堆疊、頁面 Trace
• 異常處理：顯示詳細錯誤頁面而非友好提示
• 配置緩存：禁用配置緩存，每次重新載入
• 大小寫敏感：模擬 Linux 文件系統，控制器/方法/模板大小寫嚴格區分
• 字段緩存：禁用模型字段緩存，每次查詢 SHOW COLUMNS

生產環境風險：洩露資料庫結構、絕對路徑、SQL 語句、堆疊追蹤等敏感信息，嚴禁開啟。

多入口部署架構

project/
├── public/              # Web 根目錄
│   ├── index.php        # 前台入口
│   ├── admin.php        # 後台入口
│   └── api.php          # API 入口
├── application/
│   ├── index/           # 前台模組
│   ├── admin/           # 後台模組
│   └── api/             # API 模組
├── thinkphp/            # 框架核心
└── extend/              # 擴充套件

// admin.php 範例
define('APP_PATH', __DIR__ . '/../application/');
define('BIND_MODULE', 'Admin');
define('APP_DEBUG', false);
require __DIR__ . '/../thinkphp/start.php';

安全加固清單

1. 入口文件最小化：僅保留常量定義與 require，無業務邏輯
2. 隱藏框架路徑：THINK_PATH 指向非 Web 可訪問目錄
3. 禁用目錄瀏覽：Nginx/Apache 關閉 autoindex
4. 環境變量配置：敏感配置（DB密碼、API Key）走 .env 或系統環境變量
5. 自定義錯誤頁面：THINK_PATH . 'Tpl/dispatch_jump.tpl' 覆蓋預設跳轉頁

常見部署錯誤排查

入口文件雖小，卻是整個應用的「基因密碼」。掌握常量含義、調試模式副作用、多入口架構，能讓 ThinkPHP 專案在開發、測試、生產環境間平滑流轉，避免 90% 的部署坑。