PHP get_headers() 函數完整指南：用法、參數與實戰範例

在 PHP 開發中，get_headers() 是一個極為實用的系統級函數，它能發送 HTTP 請求並回傳伺服器回應的標頭資訊陣列。若請求失敗則回傳 FALSE 並觸發 E_WARNING 錯誤，這特性常被用來判斷遠端檔案是否存在。

函數定義與參數說明

array get_headers ( string $url [, int $format = 0 ] )

• $url：目標 URL 字串。
• $format：選擇性參數，預設為 0。若設為 1，函數會解析標頭並以關聯陣列鍵名返回（如 Content-Type、Server 等），否則返回數字索引陣列。

實際程式碼範例

<?php
$url = 'https://www.example.com';

// 格式 0：數字索引陣列
print_r(get_headers($url));

// 格式 1：關聯陣列（鍵名為標頭欄位）
print_r(get_headers($url, 1));
?>

輸出結果範例

格式 0（數字索引）

Array
(
    [0] => HTTP/1.1 200 OK
    [1] => Date: Sat, 29 May 2004 12:28:13 GMT
    [2] => Server: Apache/1.3.27 (Unix) (Red-Hat/Linux)
    [3] => Last-Modified: Wed, 08 Jan 2003 23:11:55 GMT
    [4] => ETag: "3f80f-1b6-3e1cb03b"
    [5] => Accept-Ranges: bytes
    [6] => Content-Length: 438
    [7] => Connection: close
    [8] => Content-Type: text/html
)

格式 1（關聯索引）

Array
(
    [0] => HTTP/1.1 200 OK
    [Date] => Sat, 29 May 2004 12:28:14 GMT
    [Server] => Apache/1.3.27 (Unix) (Red-Hat/Linux)
    [Last-Modified] => Wed, 08 Jan 2003 23:11:55 GMT
    [ETag] => "3f80f-1b6-3e1cb03b"
    [Accept-Ranges] => bytes
    [Content-Length] => 438
    [Connection] => close
    [Content-Type] => text/html
)

常見應用場景

• 檢查遠端檔案是否存在：透過檢查回應碼（如 200 OK vs 404 Not Found）快速判斷。
• 取得資源中繼資料：如 Content-Type、Content-Length、Last-Modified 等，適合做快取驗證或檔案類型偵測。
• 偵測重導向鏈：陣列中會包含多組 Location 標頭，可追蹤重導向路徑。

注意事項

• 預設使用 GET 請求；若需 HEAD 請求可搭配 stream_context_create() 設定 method => 'HEAD'。
• 遇到 SSL 憑證問題時，可在 context 中設定 verify_peer => false（僅測試環境建議）。
• 函數會完整下載標頭，對超大型回應或緩慢伺服器可能造成延遲，建議設定 timeout context 參數。