PHP 一鍵生成靜態頁面：Output Buffering 實作輕量級靜態化方案

核心思路：攔截輸出緩衝區，落地為 HTML 檔

利用 PHP `ob_start(callback)` 機制，在腳本結束前自動將**完整輸出內容**寫入靜態檔案，同時正常輸出給瀏覽器。無需修改業務邏輯，只需在頁面最頂端 `include` 一次、呼叫 `CreateShtml()` 即可。適合內容型站點 (文章、商品詳情、列表頁) 降低資料庫壓力、提升首屏速度。

核心庫：static.php (不足 20 行)

<?php
/**
 * 啟用靜態化：在頁面最開頭 require_once 'static.php'; CreateShtml();
 * 產生檔案命名規則：腳本檔名.html (帶 ?page=N 參數則為 檔名_N.html)
 */
function CreateShtml() {
    ob_start('callback_CreateShtml');
}

function callback_CreateShtml($buffer) {
    // 1. 取得分頁參數 (預設 0 = 首頁)
    $page = intval($_REQUEST['page'] ?? 0);

    // 2. 組裝靜態檔路徑 (可自行修改儲存目錄)
    $baseName = basename($_SERVER['PHP_SELF'], '.php');
    $fileName = __DIR__ . '/static/' . $baseName . ($page === 0 ? '' : '_' . $page) . '.html';

    // 3. 確保目錄存在
    $dir = dirname($fileName);
    if (!is_dir($dir)) mkdir($dir, 0755, true);

    // 4. 寫入檔案 (二進位模式避免換行符轉換)
    $fp = fopen($fileName, 'wb');
    fwrite($fp, $buffer);
    fclose($fp);

    // 5. 返回原緩衝內容，繼續正常輸出給瀏覽器
    return $buffer;
}
?>

使用範例：phpfans.php

<?php
require_once 'static.php';
CreateShtml(); // ★ 必須在任何輸出之前
?>
<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><title>靜態化測試</title></head>
<body>
<h1>歡迎來到 PHP 靜態化演示</h1>
<p>當前時間：<?php echo date('Y-m-d H:i:s'); ?></p>
<p>分頁參數 page = <?php echo intval($_GET['page'] ?? 0); ?></p>
</body>
</html>

實際效果

• 訪問 `phpfans.php` → 產生 `static/phpfans.html`
• 訪問 `phpfans.php?page=2` → 產生 `static/phpfans_2.html`
• 後續可直接由 Nginx/Apache 靜態檔服務，完全繞過 PHP 執行。

進階擴展：生產環境就緒清單

⚠️ 避坑指南

1. 絕對要在任何輸出前呼叫：`CreateShtml()` 前不能有 `echo`、空白、BOM、HTML 標籤。
2. 權限：`static/` 目錄需 PHP 進程寫入權限 (`chown www:www static`)。
3. 編碼一致：頁面 `charset`、資料庫連線、PHP `default_charset` 統一 UTF-8。
4. 大流量並發：同一頁面同時被大量請求觸發重複生成 → 加鎖 (`flock`) 或改用「定時任務預生成 + 靜態檔直出」架構。
5. POST 請求：預設不緩存 POST (含表單提交)；callback 中可判斷 `$_SERVER['REQUEST_METHOD'] === 'GET'` 才寫檔。

對比：何時用此法、何時上完整靜態化框架？

• ✅ **適合**：中小型內容站、單機部署、快速上線、頁面結構相對固定、動態區塊少。
• ❌ **不適合**：高併發寫入、強個性化頁面 (千人千面)、多機叢集無共享存儲、需精細快取控制 (標籤、依賴、預熱) —— 請上 **Varnish/Nginx fastcgi_cache/Symfony HttpCache/Laravel Response Cache** 等專業方案。

這 20 行代碼，是理解「輸出緩衝 → 靜態落地」原理的最小模型。掌握它，你就擁有了為任何舊專案低成本加速的鑰匙。