萬盛學電腦網

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

PHP 輸出緩衝與 Gzip 壓縮輸出:核心函數詳解與實戰封裝

輸出緩衡核心函數

函數說明
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 即送出)

Gzip 壓縮輸出實戰封裝

<?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;
}
?>

效能數據參考

  • 典型 HTML 頁面壓縮率:**70%-85%** (如 100KB → 15-30KB)。
  • CPU 開銷:現代 CPU 壓縮 100KB 文字 < 1ms。
  • 傳輸時間減少:頻寬受限環境 (移動網路、跨國) 體感提升明顯。

生產環境最佳實踐:交給 Web 伺服器/CDN

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 專注業務邏輯,架構更清晰、效能更極致。

copyright © 萬盛學電腦網 all rights reserved