PHP header() 函數的基礎用法詳解

M66 2025-05-18

PHP的header()函數是一個非常常用的函數，它用於發送原始的HTTP頭信息到客戶端瀏覽器。通過這個函數，開發者可以控制頁面響應的頭部信息，從而影響瀏覽器的行為。例如，可以用它來設置重定向、修改內容類型、控制緩存等。

一、header()函數的基本用法

header()函數的基本語法如下：

 header(string $header, bool $replace = true, int $response_code = 0): void

$header ：要發送的HTTP頭信息。
$replace ：指示是否替換之前的同類型的頭信息，默認為true ，表示替換；如果為false ，則會追加新的頭信息。
$response_code ：HTTP響應碼，例如200表示成功， 301表示永久重定向， 404表示未找到頁面等。

例子：

 header("Content-Type: application/json"); // 設置響應的內容類型為JSON
header("Location: http://m66.net/redirect-page"); // 發送301重定向頭信息

二、header()函數的常見應用場景

頁面重定向
header()函數最常見的應用之一是頁面重定向。通過發送Location頭，可以將用戶重定向到另一個URL。例如：
```
 header("Location: http://m66.net/newpage"); // 將用戶重定向到新的頁面
exit(); // 確保腳本停止執行，避免繼續輸出內容
```
在此示例中，當訪問該頁面時，瀏覽器會被引導到http://m66.net/newpage 。
設置內容類型 可以使用header()函數來設置響應的內容類型例如，如果您要返回JSON數據給前端，您可以設置Content-Type頭信息為application/json ：
```
 header("Content-Type: application/json");
echo json_encode(["message" => "Hello, world!"]);
```
這告訴瀏覽器，返回的數據是JSON格式，而不是HTML或其他類型。
控制緩存 使用header()函數，您可以控制瀏覽器是否緩存某些頁面內容例如，禁用頁面緩存：
```
 header("Cache-Control: no-store, no-cache, must-revalidate");
header("Pragma: no-cache");
header("Expires: 0");
```
這會告訴瀏覽器每次都重新請求頁面，而不使用緩存內容。
發送404錯誤頁面 如果頁面沒有找到，可以通過設置HTTP狀態碼為404來告知瀏覽器這是一個“未找到”錯誤
```
header("HTTP/1.1 404 Not Found");
echo "Page not found";
```
這使得瀏覽器能夠正確處理404錯誤並展示錯誤頁面。
避免直接訪問某些文件 如果您希望防止用戶直接訪問某些敏感文件（如配置文件），可以通過header()函數檢查訪問來源並重定向用戶例如：
```
 if ($_SERVER['HTTP_REFERER'] !== 'http://m66.net/safe-zone') {
 header("Location: http://m66.net/access-denied");
 exit();
}
```

三、使用header()時的注意事項

必須在輸出前調用
header()函數需要在頁面任何輸出內容之前調用。如果頁面已經輸出了HTML或其他內容，就會導致“頭信息已經發送”的錯誤。為了避免這種錯誤，建議在PHP代碼開頭就調用header() ，並確保沒有任何輸出（包括空格或換行）。
```
 // 錯誤的使用方法：
echo "Hello, World!";
header("Location: http://m66.net/newpage");  // 會報錯

// 正確的使用方法：
header("Location: http://m66.net/newpage");  // 應該在任何輸出之前
exit();
```
使用exit()終止腳本 在發送重定向後，通常會使用exit()函數停止腳本的繼續執行，以避免之後的代碼產生意外的輸出
```
header("Location: http://m66.net/newpage");
exit();
```
調試時檢查header輸出 如果您遇到“頭信息已經發送”的錯誤，可以啟用PHP的輸出緩衝區，或者使用headers_sent()函數來調試
```
if (headers_sent($file, $line)) {
 echo "Headers already sent in $file on line $line";
}
```
確保HTTP協議正確 在使用header()函數時，確保傳遞的HTTP頭是符合協議的，比如， Location頭後面需要跟有效的URL

四、總結

header()函數是PHP中一個功能強大的工具，它能讓我們在開發中控制瀏覽器行為、改變響應頭、進行頁面重定向等操作。掌握header()函數的正確使用方法，對於開發者在處理HTTP請求、響應和頁面重定向等方面具有重要意義。

通過了解其基本用法和應用場景，你可以更好地控制瀏覽器與服務器之間的交互，提高網站的性能和用戶體驗。