在 PHP 開發中，將動態頁面生成靜態 HTML 頁面是優化網站性能、降低服務器負載的常用手段。靜態頁面無需經過 PHP 解析，直接由 Web 服務器（如 Nginx、Apache）返回給客戶端，響應速度極快，同時也有利於 SEO。本文將系統介紹三種主流的生成靜態頁方法，並提供完整代碼示例與優缺點分析，幫助開發者根據業務場景選擇最適合的方案。
這是最直觀、最基礎的方法。核心思路是：預先準備好包含佔位符的 HTML 模板文件，讀取模板內容，使用 str_replace() 將佔位符替換為實際數據，最後寫入新文件。
template/article.html），其中用 {title}、{content} 等標記佔位。file_get_contents() 讀取模板字符串。str_replace() 批量替換佔位符。file_put_contents() 將結果寫入目標靜態文件。<?php
$template = file_get_contents('template/article.html');
$data = [
'{title}' => 'PHP 生成靜態頁實戰',
'{content}' => '這裡是文章正文內容...',
'{time}' => date('Y-m-d H:i:s')
];
$html = str_replace(array_keys($data), array_values($data), $template);
file_put_contents('html/article_123.html', $html);
?>利用 PHP 的輸出控制函數（Output Control），捕獲腳本執行過程中輸出的所有內容（包括 echo、require 引入的文件輸出等），再寫入文件。這是目前最主流、靈活性最高的方法。
ob_start() 開啟輸出緩衝區。ob_get_contents() 獲取緩衝區內容。ob_clean() 或 ob_end_clean() 清空並關閉緩衝區。<?php
ob_start();
// 這裡可以執行複雜的業務邏輯，查詢數據庫等
$article = getArticleFromDB(123);
require 'template/article_detail.php'; // 模板中可直接使用 $article 變量
$html = ob_get_contents();
ob_end_clean();
$filename = 'html/article_' . $article['id'] . '.html';
file_put_contents($filename, $html);
?><!DOCTYPE html>
<html>
<head><title><?= $article['title'] ?></title></head>
<body>
<h1><?= $article['title'] ?></h1>
<div class="meta">發布時間：<?= $article['created_at'] ?></div>
<div class="content"><?= $article['content'] ?></div>
</body>
</html>header() 等輸出相關操作需謹慎處理。通過 HTTP 請求訪問動態頁面的 URL，獲取返回的 HTML 內容並保存。此法本質上是「偽裝成瀏覽器」訪問自身站點。
<?php
$url = 'https://' . $_SERVER['HTTP_HOST'] . '/article.php?id=123';
$html = file_get_contents($url); // 或使用 cURL 獲取更可控
$filename = 'html/article_123.html';
file_put_contents($filename, $html);
?>實際項目中建議封裝一個 StaticPageGenerator 類，支持多模板、分頁生成、目錄管理、錯誤重試等功能。以下是一個簡化版設計思路：
<?php
class StaticPageGenerator {
private $templateDir;
private $outputDir;
public function __construct($templateDir, $outputDir) {
$this->templateDir = rtrim($templateDir, '/');
$this->outputDir = rtrim($outputDir, '/');
if (!is_dir($this->outputDir)) mkdir($this->outputDir, 0755, true);
}
public function generate($templateName, $data, $outputFilename) {
ob_start();
extract($data); // 將數組鍵值轉為變量，模板中可直接使用 $title, $content 等
require $this->templateDir . '/' . $templateName;
$html = ob_get_clean();
return file_put_contents($this->outputDir . '/' . $outputFilename, $html);
}
// 批量生成分頁
public function generatePaginated($templateName, $items, $itemsPerPage, $baseFilename) {
$pages = array_chunk($items, $itemsPerPage);
foreach ($pages as $pageNum => $pageItems) {
$this->generate($templateName, [
'items' => $pageItems,
'currentPage' => $pageNum + 1,
'totalPages' => count($pages)
], sprintf('%s_page_%d.html', $baseFilename, $pageNum + 1));
}
}
}
// 使用示例
$generator = new StaticPageGenerator(__DIR__ . '/templates', __DIR__ . '/html');
$generator->generate('article.php', [
'title' => '深度解析 PHP 靜態化',
'content' => '詳細內容...'
], 'article_001.html');
?>templates/ 目錄，命名如 article_detail.php、list_page.php。html/{type}/{id}.html 或 html/{date}/{slug}.html 結構，避免單目錄文件過多影響文件系統性能。try_files 優先命中靜態文件，未命中再轉發 PHP；CDN 緩存靜態文件進一步提速。PHP 生成靜態頁是高性能 Web 架構的重要一環。三種方法中，輸出緩衝捕獲法（ob_get_contents）綜合表現最佳，既保留了 PHP 模板的靈活性，又避免了網絡開銷。配合合理的目錄結構、異步生成機制及 CDN 加速，可輕松支撐千萬級 PV 的內容型站點。開發者應根據業務複雜度選擇方案，並建立統一的生成工具類，提升開發效率與維護性。
