ThinkPHP 內建靜態頁生成方法 buildHtml 詳解與實戰技巧

方法簽名

$this->buildHtml('靜態文件名', '靜態路徑', '模板文件/模塊:操作');

參數深度解析

等效調用示例

// 在 IndexAction::index() 中
$this->buildHtml("index", '', "");           // 生成 Html/index.html
$this->buildHtml("index", '', "Index:index"); // 顯式指定模塊:操作
$this->buildHtml("index", '', "index");       // 簡寫（當前模塊下操作名）

實戰最佳實踐

1. 批量生成：站點建成後，編寫專用 Action 遍歷所有需靜態化的模塊/操作依次調用 buildHtml，一次性生成全站靜態頁。
2. 緩存清理：任何內容編輯或調整後，必須清空項目 Runtime/ 目錄，否則舊緩存會導致生成內容不更新。
3. 路徑規劃：建議將 HTML_PATH 設為網站根目錄，配合 Nginx/Apache 靜態文件直接轉發，實現真正的靜態化訪問。

版本說明

該方法在 TP 2.0 手冊有文檔，3.0 手冊未收錄但內核保留。升級版本時請實測驗證。