萬盛學電腦網

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

PHP 靜態頁面生成實戰:模板替換與檔案寫入完整流程

靜態化原理

核心思路:模板檔案 + 動態資料 = 靜態 HTML。模板中預留佔位符 (如 {title}、{content}),執行時讀取模板、替換佔位符、寫入靜態檔案。

完整實作流程

1. 準備動態資料 (通常來自資料庫)

$rs = [
    'title'       => '文章標題',
    'content'     => '文章內容...',
    'description' => 'SEO 描述',
    'keywords'    => '關鍵字,PHP,靜態化',
    'z_a'         => 'category',
    'sysa'        => 'system',
    'filesendid'  => 123,
];

2. 產生檔名與路徑

$fileName = md5_filename($rs[0], $rs['z_a'], $rs['filesendid']);
$path     = get_path($rs['sysa']) . $rs['z_a'] . '/';
$parent   = $_SERVER['DOCUMENT_ROOT'];
$filePath = $parent . '\\' . $path; // Windows 路徑

3. 讀取模板並批次替換

$template = $fileContent; // 假設已讀取模板檔案

$replacements = [
    '{path}'        => path($rs['z_a'], $rs['sysa']),
    '{htmlAbout}'   => htmlAbout($rs['z_a'], 10, 8, 0, ''),
    '{htmlTemplate}' => htmlTemplate(0),
    '{htmlMenu}'    => htmlMenu($rs['sysa']),
    '{htmlHelp}'    => htmlHelp($rs['sysa']),
    '{htmlNews}'    => htmlAbout($rs['z_a'], 0, 8, 0, ''),
    '{htmlHot}'     => htmlAbout($rs['z_a'], 0, 8, 1, ''),
    '{htmlSoure}'   => htmlTemplate(1),
    'php簡單生成html靜態頁面代碼' => $rs['title'], // 注意:這行疑似模板中寫死的標題
    '{htmlContent}' => $rs['content'],
    '{description}' => $rs['description'],
    '{keywords}'    => $rs['keywords'],
];

$html = str_replace(array_keys($replacements), array_values($replacements), $template);

4. 寫入靜態檔案

function makeHtml($content, $dir, $filename) {
    // 確保目錄存在
    if (!is_dir($dir)) {
        mkdir($dir, 0755, true); // 遞迴建立
    }
    
    $fullPath = $dir . $filename;
    
    // 使用 file_put_contents 簡化寫入 (PHP 5+)
    $bytes = file_put_contents($fullPath, $content, LOCK_EX);
    
    if ($bytes === false) {
        throw new Exception("靜態檔案寫入失敗: $fullPath");
    }
    
    return $fullPath;
}

// 呼叫
makeHtml($html, $filePath, $fileName);

關鍵優化點

  1. 模板編譯緩存:若模板固定,可預先編譯為 PHP 程式碼,避免重複 str_replace。
  2. 輸出緩衝捕獲:複雜頁面可用 ob_start() 包含模板檔,直接捕獲輸出。
  3. 異步生成:大流量站點應放入佇列 (Redis/RabbitMQ) 由背景 Worker 處理。
  4. CDN 配合:生成後主動推送至 CDN 或設定快取規則。
  5. 檔名策略:MD5 避免衝突,但不利 SEO;考慮 ID-slug.html 格式。

現代替代方案

  • 模板引擎:Twig, Blade, Smarty 提供繼承、區塊、過濾器等進階功能。
  • 靜態站點生成器:Jekyll, Hugo, Next.js (SSG) 更適合內容導向站點。
  • 邊緣渲染:Cloudflare Workers, Vercel Edge Functions 即時渲染無需預生成。

安全提醒

  • 目錄權限:僅授予寫入必要目錄,避免 777
  • 輸入過濾:所有動態資料輸出到 HTML 前必須 htmlspecialchars()
  • 路徑遍歷防護:檢查 $fileName 不含 ../
copyright © 萬盛學電腦網 all rights reserved