萬盛學電腦網

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

PHP 強制下載 PDF 檔案完整實作教學

預設情況下,瀏覽器會直接開啟 PDF 檔案而非下載,使用者需手動「另存新檔」才能保存。本文教你如何透過 PHP 修改 HTTP 標頭,實現點擊即強制下載 PDF 的功能。

核心原理

關鍵在於設定正確的 HTTP 回應標頭:

  • Content-Type: application/octet-stream 或 application/force-download:告知瀏覽器這是二進位檔案,需下載而非顯示
  • Content-Disposition: attachment; filename="檔名":指定下載時的檔案名稱
  • Content-Length:提供檔案大小,讓瀏覽器顯示下載進度
  • 快取控制標頭:防止 IE 等舊版瀏覽器快取導致下載異常

完整函式實作

<?php
function forceDownload($filename) {
    // 檢查檔案是否存在
    if (!file_exists($filename)) {
        return false;
    }

    // 設定 HTTP 標頭
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="' . basename($filename) . '"');
    header('Content-Length: ' . filesize($filename));

    // 相容 IE6 快取問題
    if (false === strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE 6')) {
        header('Cache-Control: no-cache, must-revalidate');
    }
    header('Pragma: no-cache');

    // 讀取檔案並輸出
    return readfile($filename);
}

// 使用範例
forceDownload("pdfdemo.pdf");
?>

關鍵細節說明

  1. 檔案路徑:確保 $filename 是伺服器上的實際路徑(相對或絕對路徑皆可)
  2. 輸出緩衝:若前有輸出內容,需先呼叫 ob_clean() 清除緩衝區
  3. 大檔案處理:超大檔案建議使用 fread 分塊輸出,避免記憶體耗盡
  4. 安全性:實際部署時請驗證檔案路徑,防止目錄遍歷攻擊

擴充應用

此函式不僅限 PDF,任何檔案類型(圖片、Excel、ZIP 等)皆適用,只需確認檔案存在即可。若需支援中文檔名,建議對檔名進行 urlencode() 處理。

copyright © 萬盛學電腦網 all rights reserved