PHP檔案下載函數大全：readfile、header、Content-Disposition等函數的檔案下載實例分析

PHP檔案下載函數大全：readfile、header、Content-Disposition等函數的檔案下載實例分析

檔案下載是Web 應用程式中不可或缺的功能之一，而PHP 作為一種廣泛使用的Web 開發語言，提供了多種實作文件下載的函數和方法。

本文將介紹 PHP 中常用的檔案下載函數，包括 readfile、header、Content-Disposition 等，並展示對應的程式碼範例，以幫助大家更好地理解和掌握檔案下載的實作方式。

一、readfile()函數

readfile() 函數是 PHP 中最常用的檔案下載函數之一，它用於讀取檔案並將其傳送到輸出流。以下是使用readfile() 函數下載檔案的基本語法範例：

$file = 'example.txt';
if (file_exists($file)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="'.basename($file).'"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));
    readfile($file);
    exit;
}

上述程式碼首先檢查檔案是否存在，然後設定輸出流的各種參數，最後使用readfile() 函數將檔案讀取並傳送到輸出流中。使用 readfile() 函數的優點是方便快捷，程式碼量少。但缺點也顯而易見，該函數會一次將整個檔案讀取到記憶體中再進行傳送，如果檔案過大，可能會導致伺服器效能瓶頸。

二、header()函數

header() 函數可以用來傳送 HTTP 標頭，它通常與 readfile() 函數結合使用來實作檔案下載。 header() 函數可以設定多種 HTTP 標頭，其中包括 Content-Type、Content-Disposition、Content-Length 等。

下面是一個使用header() 函數和readfile() 函數結合實作檔案下載的範例：

$file = 'example.txt';
if (file_exists($file)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="'.basename($file).'"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));
    ob_clean();
    flush();
    readfile($file);
    exit;
}

上述程式碼與先前的範例程式碼相似，唯一不同的是新增了ob_clean( ) 和flush() 函數。 ob_clean() 函數可以清空輸出緩衝區，確保能夠正確傳送回應頭。 flush() 函數可以強制把所有輸出送到客戶端。

三、Content-Disposition

Content-Disposition 是一種 HTTP 標頭，用於指示如何處理傳輸的數據，例如是否以「附件」的形式下載檔案。透過設定 Content-Disposition 標頭，我們可以在下載時指定檔案的名稱。

下面是一個使用Content-Disposition 標頭實作檔案下載的範例：

$file = 'example.txt';
if (file_exists($file)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="example.txt"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));
    ob_clean();
    flush();
    readfile($file);
    exit;
}

與先前的範例程式碼相比，這次我們在Content-Disposition 標頭中指定了檔案名，而沒有使用basename() 函數從檔案路徑中提取檔案名稱。需要注意的是，filename="example.txt" 中的引號是必要的，否則瀏覽器可能會在檔案名稱中包含空格時出現解析錯誤。

其他注意事項

在使用檔案下載函數時，我們還需要注意以下幾點：

1.檔案路徑必須是相對路徑或絕對路徑，不能是URL，否則會導致下載失敗。

2.使用 header() 函數設定 HTTP 標頭時，必須在輸出任何內容之前呼叫。

3.新增 ob_clean() 和 flush() 函數可以避免某些回應頭發送失敗的問題。

4.如果下載的檔案非常大，應該考慮分段下載或使用其他的下載最佳化方式。

總結

PHP 檔案下載函數主要包括 readfile、header、Content-Disposition 等。使用這些函數可以方便快速地實現文件下載功能，但需要注意檔案路徑、HTTP 標頭設定、緩衝清理等問題，以確保下載能夠正常進行。對於大文件，還需要考慮下載的效能和效率問題。

以上是PHP檔案下載函數大全：readfile、header、Content-Disposition等函數的檔案下載實例分析的詳細內容。更多資訊請關注PHP中文網其他相關文章！