php中三種下載文件的方法

# PHP中三種下載文件的方法

在Web開發中，文件下載是常見的功能需求。PHP提供了多種實現文件下載的方式，本文將詳細介紹三種主流方法，并分析其適用場景和注意事項。

## 一、使用header()函數直接輸出文件（基礎方法）

### 1.1 核心實現原理

這是PHP中最基礎的下載實現方式，通過設置HTTP響應頭強制瀏覽器觸發下載行為：

```php
<?php
$file_path = '/path/to/your/file.pdf';
$file_name = 'custom_name.pdf';

if(file_exists($file_path)){
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="'.basename($file_name).'"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file_path));
    flush(); // 清空輸出緩沖區
    readfile($file_path);
    exit;
}else{
    die('文件不存在！');
}

1.2 關鍵頭信息解析

• Content-Type: application/octet-stream：聲明二進制流文件
• Content-Disposition: attachment：強制下載而非打開
• Content-Length：指定文件大?。ㄖ匾M度條顯示）

1.3 優缺點分析

優點： - 實現簡單直接 - 不消耗額外內存 - 支持大文件下載（使用readfile()分塊讀?。?/p>

缺點： - 無法隱藏真實文件路徑 - 需要精確控制輸出（任何額外輸出都會導致失?。?- 缺乏下載權限控制

1.4 安全增強方案

// 檢查用戶權限示例
if(!$user->hasDownloadPermission()){
    header('HTTP/1.0 403 Forbidden');
    die('無權訪問此文件');
}

// 防止目錄穿越攻擊
$file_path = realpath(BASE_DIR . $_GET['file']);
if(strpos($file_path, BASE_DIR) !== 0){
    die('非法文件路徑！');
}

二、使用文件流分塊下載（大文件優化方案）

2.1 分塊下載實現

對于超大文件（如500MB+），直接readfile可能導致內存問題，應采用分塊讀?。?/p>

$chunk_size = 1024 * 1024; // 1MB/塊
$handle = fopen($file_path, 'rb');

while(!feof($handle)){
    echo fread($handle, $chunk_size);
    ob_flush();
    flush();
}

fclose($handle);

2.2 斷點續傳實現

通過支持HTTP Range頭實現斷點續傳：

$file_size = filesize($file_path);
$start = 0;
$end = $file_size - 1;

if(isset($_SERVER['HTTP_RANGE'])){
    if(preg_match('/bytes=(\d+)-(\d+)?/', $_SERVER['HTTP_RANGE'], $matches)){
        $start = intval($matches[1]);
        if(isset($matches[2])){
            $end = intval($matches[2]);
        }
    }
    header('HTTP/1.1 206 Partial Content');
    header("Content-Range: bytes $start-$end/$file_size");
}

header("Accept-Ranges: bytes");
header("Content-Length: " . ($end - $start + 1));

$handle = fopen($file_path, 'rb');
fseek($handle, $start);
// ...繼續分塊輸出...

三、通過PHP擴展實現（高級方案）

3.1 使用cURL擴展

適用于需要從遠程服務器下載后轉發的場景：

$remote_url = 'https://example.com/large_file.zip';
$local_name = 'downloaded.zip';

$ch = curl_init($remote_url);
$fp = fopen('php://output', 'w');

curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

// 設置下載頭
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="'.$local_name.'"');

curl_exec($ch);
curl_close($ch);
fclose($fp);

3.2 使用SPL擴展的SplFileObject

面向對象風格的解決方案：

$file = new SplFileObject($file_path, 'rb');

header('Content-Type: '.mime_content_type($file_path));
header('Content-Length: '.$file->getSize());
header('Content-Disposition: attachment; filename="'.$file->getFilename().'"');

foreach($file as $line){
    echo $line;
}

四、方案對比與選型建議

五、安全注意事項

1. 路徑安全：始終使用realpath()驗證路徑

   $base = '/safe/directory/';
   $path = realpath($base.$_GET['file']);
   if(strpos($path, $base) !== 0){
      die('非法訪問！');
   }
   

2. 下載限速：防止服務器帶寬被耗盡

   $speed = 100; // KB/s
   $chunk_size = $speed * 1024;
   while(!feof($handle)){
      echo fread($handle, $chunk_size);
      flush();
      sleep(1);
   }
   

3. 日志記錄：記錄下載行為

   $log = sprintf("[%s] IP:%s 下載:%s 大小:%d\n",
      date('Y-m-d H:i:s'),
      $_SERVER['REMOTE_ADDR'],
      $file_name,
      filesize($file_path));
   file_put_contents('download.log', $log, FILE_APPEND);
   

六、擴展方案：打包下載

使用ZipArchive實現多文件打包下載：

$zip = new ZipArchive();
$zip_name = 'package_'.time().'.zip';

if($zip->open($zip_name, ZipArchive::CREATE) === TRUE){
    $files = ['file1.pdf', 'file2.jpg'];
    foreach($files as $file){
        $zip->addFile($file);
    }
    $zip->close();
    
    header('Content-Type: application/zip');
    header('Content-Disposition: attachment; filename="'.$zip_name.'"');
    readfile($zip_name);
    unlink($zip_name); // 刪除臨時文件
}

結語

根據實際需求選擇合適的方法： - 簡單場景使用基礎header方法 - 大文件務必采用分塊下載 - 特殊需求考慮擴展方案

建議結合業務需求添加權限驗證、下載統計、限速控制等增強功能，構建安全可靠的下載系統。 “`

注：本文實際約1700字，包含了代碼示例、對比表格和詳細說明?？筛鶕枰{整具體實現細節或補充特定框架（如Laravel）的下載實現方案。