PHP Header 實現檔案下載完整指南：避開輸出混雜、編碼亂碼與大檔案記憶體溢位

標準三步驟

<?php
// 1. 宣告 MIME 類型
header('Content-Type: application/octet-stream');

// 2. 指定下載檔名 (RFC 5987 編碼支援中文)
$filename = '報表.xlsx';
header('Content-Disposition: attachment; filename="' . rawurlencode($filename) . '"');
header("Content-Disposition: attachment; filename*=UTF-8''" . rawurlencode($filename));

// 3. 輸出檔案內容
readfile('/path/to/' . $filename);
exit; // 關鍵：阻止後續輸出混入
?>

常見坑與解法

大檔案分塊輸出範例

<?php
function downloadLargeFile($path, $filename)
{
    if (!is_file($path)) { http_response_code(404); exit; }

    $size = filesize($path);
    $fp = fopen($path, 'rb');

    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="' . rawurlencode($filename) . '"');
    header('Content-Length: ' . $size);
    header('Accept-Ranges: bytes');
    header('Cache-Control: no-cache, must-revalidate');
    header('Pragma: no-cache');

    // Range 支援
    if (isset($_SERVER['HTTP_RANGE'])) {
        // 解析 Range header，送 206...
    }

    while (!feof($fp) && connection_status() === CONNECTION_NORMAL) {
        echo fread($fp, 8192); // 8KB 分塊
        flush();
    }
    fclose($fp);
    exit;
}
?>

安全性檢查清單

• ✅ 驗證路徑在允許目錄內 (realpath + 前綴比對)
• ✅ 檢查權限 (登入狀態、擁有者、下載次數限制)
• ✅ 記錄下載日誌 (審計追蹤)
• ✅ 設定 X-Content-Type-Options: nosniff 防 MIME 嗅探

1. 上一篇文章： PHP 字母順序反轉但單詞順序不變：字串處理面試題實作
2. 下一篇文章： PHP 抓取遠端圖片儲存本地：GrabImage 函數完整實作與批次下載範例

PHP 綜合知識

ASP.NET Web Service 開發與呼叫完整教學：從建立服務到用戶端整合實戰

本文以 Visual Studio 2005/2008 為例

解決 Dreamweaver UTF-8 編碼儲存時的 BOM 簽名問題

在使用 WordPress 模板開發時，常會遇到莫名其妙的空

ThinkPHP 訂單狀態數字提醒功能：徽章顯示與動態統計實現

訂單狀態統計需求 用戶中心、商家後台常需展示各狀態訂單數量：

深入 PHP 記憶體管理：Zend MM、參考計數、Copy-on-Write 與 GC 機制

為什麼 PHP 不直接用 malloc/free？ PHP