如何通過header() 實現強制瀏覽器下載文件而不是打開

M66 2025-05-18

在Web 開發中，某些時候我們希望用戶能夠下載文件，而不是在瀏覽器中查看它們。這時，我們可以利用PHP 的header()函數來實現這一需求。 header()函數允許你發送原始的HTTP 頭部信息，能夠控制瀏覽器的行為。

本文將向你展示如何通過header()函數來強制瀏覽器下載文件，而不是直接打開它。

步驟1：準備文件

首先，你需要確保文件已經準備好，並且你知道它的路徑。例如，假設你有一個文件位於服務器的某個目錄下，路徑為/path/to/your/file.txt 。你希望用戶下載這個文件，而不是直接在瀏覽器中查看它。

步驟2：使用header()函數設置正確的頭部

為了強制瀏覽器下載文件，必須設置正確的HTTP 頭部。 PHP 的header()函數允許你發送各種HTTP 頭信息，具體步驟如下：

 <?php
// 設置文件路徑
$file = '/path/to/your/file.txt';

// 檢查文件是否存在
if (file_exists($file)) {
    // 設置正確的 MIME 類型
    header('Content-Type: application/octet-stream');
    
    // 指定下載的文件名
    header('Content-Disposition: attachment; filename="' . basename($file) . '"');
    
    // 設置文件大小
    header('Content-Length: ' . filesize($file));
    
    // 清空輸出緩衝區
    ob_clean();
    flush();
    
    // 輸出文件內容到瀏覽器
    readfile($file);
    exit;
} else {
    // 如果文件不存在，提示錯誤
    echo '文件未找到！';
}
?>

代碼解釋：

header('Content-Type: application/octet-stream')
這行代碼告訴瀏覽器文件是一個二進制流，瀏覽器應該把它作為文件處理，而不是嘗試直接顯示它。
header('Content-Disposition: attachment; filename="file.txt"')
這裡設置了文件的下載方式為附件（ attachment ），並指定了下載時的文件名為file.txt 。你可以根據需要修改文件名。
header('Content-Length: ' . filesize($file))
這行代碼設置了文件的大小，幫助瀏覽器了解文件的大小，便於下載進度的顯示。
ob_clean()和flush()
這些函數用於清空PHP 的輸出緩衝區，以確保文件內容正確傳送到瀏覽器。
readfile($file)
該函數將文件內容輸出到瀏覽器，從而觸發文件下載。
exit
調用exit()終止PHP 腳本的執行，確保文件下載的過程中沒有其他不必要的輸出。

步驟3：測試

現在，你可以在瀏覽器中訪問PHP 腳本。假設腳本文件名為download.php ，你只需訪問http://m66.net/download.php （注意將URL 替換成你實際的文件路徑）。如果一切配置正確，瀏覽器會提示你下載文件，而不是直接在瀏覽器中打開它。

常見問題

文件無法下載<br> 如果文件沒有下載，確保文件路徑正確，並且PHP 腳本有足夠的權限訪問該文件
文件下載後為空<br> 確保文件內容沒有損壞，並且輸出緩衝區沒有被不正確地清理可以嘗試註釋掉ob_clean()和flush()看看是否有效。
下載文件的MIME 類型問題<br> 如果文件類型較為特殊（如PDF、ZIP 等），你可以根據文件類型設置不同的MIME 類型例如：
```
 header('Content-Type: application/pdf'); // 對於 PDF 文件
header('Content-Type: application/zip'); // 對於 ZIP 文件
```

通過這種方式，PHP 的header()函數幫助你控製文件的下載行為，使得用戶可以按照預期下載文件，而不是在瀏覽器中直接查看它們。