萬盛學電腦網

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

PHP 網頁快取控制與 GZIP 壓縮傳輸完整實作指南

兩大核心優化:快取策略 + 傳輸壓縮

正確設定 HTTP 快取標頭與啟用 GZIP 壓縮,能大幅降低頻寬、縮短載入時間、改善 SEO 與使用者體驗。

一、PHP 端快取控制標頭

Cache-Control (HTTP/1.1 標準,推薦)

<?php
// 完全不快取(動態內容、API、用戶專屬頁面)
header("Cache-Control: no-store, no-cache, must-revalidate, max-age=0");
header("Pragma: no-cache"); // HTTP/1.0 相容
header("Expires: 0");

// 靜態資源長期快取(CSS、JS、圖片、字型)
// max-age=31536000 (1年),immutable 表示內容永不變更
header("Cache-Control: public, max-age=31536000, immutable");

// 須驗證快取(大多數動態頁面)
// max-age=0 必須向伺服器驗證,etag/last-modified 機制決定是否 304
header("Cache-Control: max-age=0, must-revalidate");
?>

Expires (HTTP/1.0 相容)

<?php
// 24 小時後過期
$offset = 3600 * 24;
$expire = "Expires: " . gmdate("D, d M Y H:i:s", time() + $offset) . " GMT";
header($expire);
?>

Last-Modified / ETag 驗證機制

<?php
$lastModified = filemtime(__FILE__); // 或資料庫更新時間
$etag = md5($lastModified . $content); // 內容雜湊

// 發送驗證標頭
header("Last-Modified: " . gmdate("D, d M Y H:i:s", $lastModified) . " GMT");
header("ETag: \"$etag\"");

// 檢查客戶端快取是否有效
$clientETag = $_SERVER['HTTP_IF_NONE_MATCH'] ?? '';
$clientModified = $_SERVER['HTTP_IF_MODIFIED_SINCE'] ?? '';

if ($clientETag === "\"$etag\"" || strtotime($clientModified) >= $lastModified) {
    header("HTTP/1.1 304 Not Modified");
    exit; // 節省頻寬,不傳送內容
}
?>

二、PHP 端啟用 GZIP 壓縮輸出

方法 1:ob_gzhandler(簡單、自動偵測瀏覽器支援)

<?php
// 必須在任何輸出前呼叫
ob_start("ob_gzhandler");

// 你的 PHP 程式碼...
echo "<html><body>大量 HTML 內容...</body></html>";

// 結束時自動壓縮輸出並發送 Content-Encoding: gzip
ob_end_flush();
?>

方法 2:手動控制(需檢查 Accept-Encoding)

<?php
// 檢查瀏覽器支援 gzip
if (strpos($_SERVER['HTTP_ACCEPT_ENCODING'] ?? '', 'gzip') !== false) {
    ob_start(function ($buffer) {
        return gzencode($buffer, 5); // 壓縮等級 1-9,5 為平衡點
    });
    header("Content-Encoding: gzip");
    header("Vary: Accept-Encoding"); // 告知 Proxy 依 Accept-Encoding 快取不同版本
}

// 程式碼...
echo "內容...";

ob_end_flush();
?>

方法 3:zlib.output_compression (php.ini 設定,零程式碼)

; php.ini
zlib.output_compression = On
zlib.output_compression_level = 5
; 注意:不可同時使用 ob_gzhandler 或 output_handler

三、Web Server 層面啟用 GZIP(效能最佳、不佔 PHP 程序資源)

Apache (mod_deflate)

<IfModule mod_deflate.c>
    # 啟用壓縮
    SetOutputFilter DEFLATE
    DeflateCompressionLevel 5
    
    # 指定壓縮的 MIME 類型
    AddOutputFilterByType DEFLATE \
        text/html text/plain text/xml text/css \
        text/javascript application/javascript application/json \
        application/xml application/rss+xml \
        image/svg+xml font/woff font/woff2
    
    # 排除已壓縮格式(圖片、影片、壓縮檔)
    SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png|webp|ico|zip|gz|pdf|woff2?)$ no-gzip
    
    # 避免舊版瀏覽器問題
    BrowserMatch ^Mozilla/4 gzip-only-text/html
    BrowserMatch ^Mozilla/4\.0[678] no-gzip
    BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
</IfModule>

Nginx (ngx_http_gzip_module)

# nginx.conf http 區塊
gzip on;
gzip_vary on;
gzip_comp_level 5;
gzip_min_length 1024;        # 最小壓縮位元組
gzip_types 
    text/plain text/css text/xml text/javascript
    application/javascript application/json application/xml
    application/rss+xml
    image/svg+xml font/woff font/woff2;
gzip_disable "msie6";        # 禁用 IE6
# 靜態檔案預壓縮(需編譯 ngx_http_gzip_static_module)
# gzip_static on;            

IIS (web.config)

<configuration>
  <system.webServer>
    <urlCompression doStaticCompression="true" doDynamicCompression="true" />
    <httpCompression>
      <dynamicTypes>
        <add mimeType="text/*" enabled="true" />
        <add mimeType="application/javascript" enabled="true" />
        <add mimeType="application/json" enabled="true" />
        <add mimeType="*/*" enabled="false" />
      </dynamicTypes>
      <staticTypes>
        <add mimeType="text/*" enabled="true" />
        <add mimeType="application/javascript" enabled="true" />
        <add mimeType="*/*" enabled="false" />
      </staticTypes>
    </httpCompression>
  </system.webServer>
</configuration>

四、快取與壓縮的最佳實踐組合

靜態資源(CSS/JS/圖片/字型)

  • Web Server 直接服務(Nginx/Apache 靜態檔案處理最快)
  • 長期快取:Cache-Control: public, max-age=31536000, immutable
  • 檔名加雜湊:app.a1b2c3.js 內容變更即檔名變更,安全長期快取
  • GZIP/Brotli 預壓縮:gzip_static on + brotli_static on

動態頁面(HTML/API)

  • 短期/驗證快取:Cache-Control: max-age=0, must-revalidate + ETag/Last-Modified
  • GZIP 動態壓縮:Web Server 層處理(mod_deflate/ngx_http_gzip_module)
  • 私有內容:Cache-Control: private, max-age=0, must-revalidate

API 回應

  • 無快取:Cache-Control: no-store
  • GZIP 壓縮 JSON:效果極佳(文字壓縮率 70-90%)
  • Vary 標頭:Vary: Accept-Encoding, Authorization

五、驗證工具與除錯

工具用途
Chrome DevTools Network檢查 Response Headers:content-encoding: gzip, cache-control, etag, 304
curlcurl -I -H "Accept-Encoding: gzip" https://example.com
RedBot紅色機器人 分析快取標頭合規性
PageSpeed InsightsGoogle 官方效能評分含快取建議
GTmetrix詳細瀑布圖與壓縮率分析

常見錯誤避坑

  • ❌ ob_start("ob_gzhandler") 後又手動 gzencode() → 雙重壓縮破壞內容
  • ❌ 壓縮已壓縮格式(jpg, png, zip, pdf, woff2)→ 浪費 CPU、檔案變大
  • ❌ 動態頁面設長期快取無驗證機制 → 使用者看舊資料
  • ❌ 忘記 Vary: Accept-Encoding → Proxy 快取錯誤版本給不支援 gzip 的客戶端
  • ❌ PHP 輸出前有空白/換行 → 導致 Cannot modify header information

總結

**快取策略分層**:Web Server 處理靜態資源長期快取 + GZIP/Brotli 壓縮;PHP 應用層處理動態內容驗證快取(ETag/Last-Modified)+ 業務邏輯快取。優先在 Web Server 層啟用壓縮,效能最好且不佔用 PHP Worker 資源。配合正確的 Cache-Control、ETag、Vary 標頭,打造高速、省頻寬、SEO 友善的現代 Web 應用。

copyright © 萬盛學電腦網 all rights reserved