PHP header() 控制頁面快取：從禁用快取到設定過期時間

前言

透過 header() 送出正確的 HTTP 快取標頭，可大幅降低伺服器負載、加快頁面載入。本文說明「禁用快取」與「啟用快取」兩大場景的標頭設定，並補充 Apache mod_expires 靜態檔案快取設定。

禁用快取（動態內容、敏感頁面）

header("Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0"); // HTTP/1.1
header("Expires: Sat, 26 Jul 1997 05:00:00 GMT"); // 過去日期
header("Pragma: no-cache"); // HTTP/1.0 相容

注意： header() 前不可有任何輸出（含空白、BOM）。

啟用快取（公開資源、半動態頁面）

PHP 動態輸出設定快取 1 小時

$seconds = 3600;
$ts = gmdate("D, d M Y H:i:s", time() + $seconds) . " GMT";
header("Expires: $ts");
header("Pragma: cache");
header("Cache-Control: max-age=$seconds");

關鍵： 使用 gmdate 而非 date 產生 GMT 時間，避免時區誤差。

快取 1 個月範例

header("Cache-Control: public");
header("Pragma: cache");
$offset = 30 * 24 * 3600;
$expStr = "Expires: " . gmdate("D, d M Y H:i:s", time() + $offset) . " GMT";
header($expStr);

ETag 與 Last-Modified 進階快取驗證

針對內容變動不頻繁的動態頁，可產生 ETag：

$content = getContent(); // 取得輸出內容
$etag = md5($content);
header("ETag: $etag");
if (isset($_SERVER['HTTP_IF_NONE_MATCH']) && $_SERVER['HTTP_IF_NONE_MATCH'] === $etag) {
    header("HTTP/1.1 304 Not Modified");
    exit;
}
echo $content;

靜態檔案快取：Apache mod_expires

在 .htaccess 加入：

<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType image/gif "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType text/css "access plus 1 month"
ExpiresByType application/javascript "access plus 1 month"
ExpiresByType text/html "access plus 10 minutes"
</IfModule>

若模組未安裝，規則會被忽略不報錯。建議搭配 Gzip 壓縮（mod_deflate）使用。

常見誤區

• header("Cache-Control: max-age=...") 與 Expires 時間必須一致，否則瀏覽器行為不可預期。
• 動態頁面若設定長期快取，更新資料後使用者可能看舊內容，需配合版本號或 ETag 失效機制。
• session_start() 會自動送出 Cache-Control: no-store，若需快取 Session 頁面，需在 session_start 後覆寫標頭。