萬盛學電腦網

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

PHP header() 函數詳解:瀏覽器快取控制、檔案下載、重導向、狀態碼完整指南

核心規則

header() 必須在任何實際輸出之前呼叫(含空白、BOM、echo、HTML)。PHP 4+ 可用 ob_start() 緩衝輸出解決順序問題。

常用 Header 應用場景

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');

// 靜態資源長期快取 (1 年)
header('Cache-Control: public, max-age=31536000, immutable');
header('Expires: ' . gmdate('D, d M Y H:i:s', time() + 31536000) . ' GMT');

// 依據資料庫更新時間動態快取 (範例 ID 176828)
$lastMod = $db->query("SELECT UNIX_TIMESTAMP(MAX(updated_at)) FROM posts")->fetchColumn();
$interval = 6 * 3600; // 6 小時
header('Last-Modified: ' . gmdate('D, d M Y H:i:s', $lastMod) . ' GMT');
header('Expires: ' . gmdate('D, d M Y H:i:s', $lastMod + $interval) . ' GMT');
header('Cache-Control: max-age=' . $interval);

2. 檔案下載 (強制「另存新檔」)

$file = '/var/data/report.pdf';
$filename = 'monthly_report.pdf';

header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="' . rawurlencode($filename) . '"');
header('Content-Length: ' . filesize($file));
header('X-Content-Type-Options: nosniff'); // 防 MIME 嗅探
readfile($file); // 直接輸出檔案內容,不佔用 PHP 記憶體

3. 重導向

4. 設定 HTTP 狀態碼

header('HTTP/1.1 404 Not Found');
header('HTTP/1.1 403 Forbidden');
header('HTTP/1.1 500 Internal Server Error');

5. CORS 跨域授權 (API 常用)

header('Access-Control-Allow-Origin: https://app.example.com');
header('Access-Control-Allow-Methods: GET, POST, OPTIONS');
header('Access-Control-Allow-Headers: Content-Type, Authorization');
header('Access-Control-Allow-Credentials: true');

語法與參數

header(string $header, bool $replace = true, int $response_code = 0): void
  • $replace:同名 Header 是否覆蓋(預設 true)。
  • $response_code:強制設定回應碼(PHP 4.3+)。

常見錯誤與除錯

  1. 「Cannot modify header information - headers already sent」:檢查是否有 BOM、include 檔案尾部空白、echo/print、錯誤訊息輸出。用 headers_sent($file, $line) 定位輸出位置。
  2. 中文檔名下載亂碼:用 rawurlencode() 編碼檔名,現代瀏覽器支援 RFC 5987 filename*=UTF-8''... 格式。
  3. 重導向後代碼仍執行:務必加 exit; 或 die();。
copyright © 萬盛學電腦網 all rights reserved