利用 PHP 輸出緩衝(Output Buffering)捕獲腳本輸出,經回調函數處理後寫入靜態 HTML 文件,實現「動態生成、靜態訪問」的性能優化。
<?php
/**
* 啟動靜態頁生成緩衝
* @param string $dir 靜態文件存放目錄(相對文檔根目錄)
* @param string $prefix 文件名前綴
*/
function CreateShtml($dir = 'article', $prefix = '') {
// 註冊回調,緩衝結束時自動執行
ob_start(function($buffer) use ($dir, $prefix) {
return callback_CreateShtml($buffer, $dir, $prefix);
});
}
/**
* 靜態頁生成回調
* @param string $buffer 緩衝內容
* @param string $dir 存放目錄
* @param string $prefix 文件名前綴
* @return string 原始緩衝(保持頁面正常輸出)
*/
function callback_CreateShtml($buffer, $dir, $prefix) {
// 解析分頁參數
$page = isset($_REQUEST['page']) ? intval($_REQUEST['page']) : 0;
// 構建文件路徑
$base_name = basename($_SERVER['PHP_SELF'], '.php');
$file_name = $prefix . $base_name . ($page === 0 ? '' : '_' . $page) . '.html';
$file_path = $_SERVER['DOCUMENT_ROOT'] . '/' . $dir . '/' . $file_name;
// 確保目錄存在
$dir_path = dirname($file_path);
if (!is_dir($dir_path)) {
mkdir($dir_path, 0755, true);
}
// 寫入文件
$fp = fopen($file_path, 'wb');
if ($fp) {
fwrite($fp, $buffer);
fclose($fp);
}
return $buffer; // 必須返回,否則頁面空白
}
?>
<?php
require_once 'static.php';
// 必須在任何輸出前調用
CreateShtml('article', 'phpfans_');
?>
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>PHP 愛好者站點</title>
</head>
<body>
<?php echo "歡迎訪問 PHP 愛好者站,https://www.phpfans.net"; ?>
</body>
</html>
// 策略模式:文件、Redis、S3 等
interface StaticStorage {
public function save(string $path, string $content): bool;
}
class FileStorage implements StaticStorage {
public function save(string $path, string $content): bool {
$dir = dirname($path);
if (!is_dir($dir)) mkdir($dir, 0755, true);
return file_put_contents($path, $content, LOCK_EX) !== false;
}
}
article_v20240115.htmlfind -mtime +7 -delete 定期清理舊版本location /article/ {
try_files $uri $uri/ @php_fallback;
}
location @php_fallback {
fastcgi_pass php-fpm;
# 動態生成並返回
}
| 問題 | 原因 | 解決 |
|---|---|---|
| 生成文件為空 | 回調未返回 $buffer |
回調函數末尾 return $buffer; |
| 中文亂碼 | 文件編碼與頁面 charset 不一致 | 統一 UTF-8,fopen($path, 'wb') 二進制寫入 |
| 權限拒絕 | 目錄不可寫 | PHP-FPM 進程用戶擁有目錄寫權限 |
| 高併發下文件損壞 | 無鎖機制 | file_put_contents(..., LOCK_EX) 或分佈式鎖 |
輸出緩衝 + 回調寫入是 PHP 生成靜態頁最輕量的原生方案。結合合理的目錄結構、過期策略、Nginx 直讀配置,可顯著降低動態腳本執行壓力,提升首屏加載速度。對於大型系統,建議引入專靜態化框架或 SSG(靜態站點生成器)工具鏈。