| 函數 | 說明 |
|---|---|
ob_start(callable $callback=null, int $chunk_size=0, int $flags=0) | 開啟緩衝,可選回調處理輸出 (如壓縮) |
ob_get_contents() | 取得緩衝區字串 (不清空) |
ob_get_length() | 取得緩衝區長度 (位元組) |
ob_end_flush() | 輸出緩衝內容並關閉緩衝 |
ob_end_clean() | 丟棄緩衝內容並關閉緩衝 |
ob_get_clean() | 取得內容並關閉清空 (等同 get_contents + end_clean) |
ob_implicit_flush(bool $flag) | 開啟/關閉隱性刷新 (每次 echo 即送出) |
<?php
/**
* 啟用 Gzip 輸出壓縮 (需 PHP 編譯支援 zlib)
* 放在入口檔案最頂部,任何輸出之前
*/
function enableGzipCompression(): void
{
// 1. 檢查 zlib 支援
if (!extension_loaded('zlib')) return;
// 2. 檢查客戶端支援
$acceptEncoding = $_SERVER['HTTP_ACCEPT_ENCODING'] ?? '';
if (stripos($acceptEncoding, 'gzip') === false) return;
// 3. 已經有輸出或 Header 已送出則跳過
if (headers_sent() || ob_get_level() > 0) return;
// 4. 開啟緩衝並註冊壓縮回調
ob_start(function ($buffer) {
// 避免二進位內容 (圖片、PDF) 被壓縮
$contentType = headers_list()[0] ?? '';
if (stripos($contentType, 'image/') !== false ||
stripos($contentType, 'application/pdf') !== false ||
stripos($contentType, 'application/zip') !== false) {
return $buffer;
}
// 壓縮等級 6 (平衡 CPU/壓縮率),FORCE_GZIP 確保輸出 gzip 格式
$compressed = gzencode($buffer, 6, FORCE_GZIP);
// 發送 Header
header('Content-Encoding: gzip');
header('Vary: Accept-Encoding');
header('Content-Length: ' . strlen($compressed));
return $compressed;
});
// 5. 關閉隱性刷新,確保整頁緩衝後一次壓縮
ob_implicit_flush(false);
}
// 入口檔案 (index.php / bootstrap.php) 最早呼叫
enableGzipCompression();
// 後續正常開發:echo、include 模板、框架運行...
?>
<?php
ob_start();
ob_implicit_flush(0);
// ... 所有業務邏輯、模板渲染 ...
echo $hugeHtmlContent;
// 頁面結束前手動處理
$content = ob_get_contents();
ob_end_clean();
if (extension_loaded('zlib') && stripos($_SERVER['HTTP_ACCEPT_ENCODING'] ?? '', 'gzip') !== false) {
header('Content-Encoding: gzip');
header('Vary: Accept-Encoding');
echo gzencode($content, 6, FORCE_GZIP);
} else {
echo $content;
}
?>
Nginx:
gzip on; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
Apache:mod_deflate+AddOutputFilterByType DEFLATE text/html text/css application/json
CDN (Cloudflare, AWS CloudFront, CloudFront):邊緣節點自動壓縮,減輕源站 CPU。
PHP 層壓縮僅作為:無法控制 Web 伺服器設定的共享主機、特定路由需動態決定是否壓縮、舊版專案快速加裝。
輸出緩衝是 PHP 控制 HTTP 回應的核心機制。掌握 ob_start 回調模式與手動模式,能實現 Gzip 壓縮、模板渲染捕獲、Header 後置發送等進階功能。但生產環境高流量場景,**壓縮應下沉到 Nginx/Apache/CDN 層**,PHP 專注業務邏輯,架構更清晰、效能更極致。