萬盛學電腦網

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

PHP 實現文件下載限速:分塊輸出 + sleep 節流完整示例

原理

通過 fread() 分塊讀取文件,每發送一塊調用 flush() 刷新輸出緩衝區,再 sleep(1) 暫停 1 秒,即可將下載速度限制在 塊大小 / 秒。適合會員專屬下載、防盜鏈、帶寬成本控制等場景。

完整代碼

<?php
// 配置區
$local_file = 'test-file.zip';        // 服務器本地文件路徑
$download_file = 'your-download-name.zip'; // 用戶下載時的文件名
$download_rate = 20.5;                // 限速 KB/s(這裡約 20.5 KB/s)

if (file_exists($local_file) && is_file($local_file)) {
    // 1. 發送下載頭
    header('Cache-Control: private');
    header('Content-Type: application/octet-stream');
    header('Content-Length: ' . filesize($local_file));
    header('Content-Disposition: filename="' . $download_file . '"');
    flush(); // 立即發送頭信息

    // 2. 打開文件流
    $file = fopen($local_file, 'rb'); // 二進制模式
    if (!$file) die('無法打開文件');

    // 3. 循環分塊輸出
    $chunkSize = round($download_rate * 1024); // 字節/秒
    while (!feof($file)) {
        echo fread($file, $chunkSize); // 發送數據
        flush(); // 強制輸出到瀏覽器
        sleep(1); // 節流 1 秒
    }

    // 4. 清理
    fclose($file);
    exit; // 確保無額外輸出
} else {
    die('錯誤:文件 ' . $local_file . ' 不存在!');
}

關鍵點解析

關鍵點說明
Content-Length必須設置,否則瀏覽器無法顯示進度條,且可能導致連接過早關閉
flush()刷新 PHP 輸出緩衝區到 Web Server,再由 Web Server 發送到客戶端;需確保 Web Server 未開啟額外緩衝(如 Nginx proxy_buffering off)
sleep(1)粒度為秒;若需更精細控制(如 100KB/s),可用 usleep() 配合更小塊
fopen 'rb' 模式Windows 下必須加 b 避免換行符轉換損壞二進制文件
忽略用戶中斷加 ignore_user_abort(true) 防止用戶取消導致腳本中止留下臨時文件

進階版:支援斷點續傳(HTTP Range)

// 簡易 Range 支持
$fileSize = filesize($local_file);
$range = $_SERVER['HTTP_RANGE'] ?? '';
if ($range) {
    list($unit, $range) = explode('=', $range, 2);
    if ($unit === 'bytes' && preg_match('/^(\d+)-(\d*)$/', $range, $m)) {
        $start = intval($m[1]);
        $end = $m[2] ? intval($m[2]) : $fileSize - 1;
        if ($start < $fileSize && $end < $fileSize) {
            header('HTTP/1.1 206 Partial Content');
            header('Content-Range: bytes ' . $start . '-' . $end . '/' . $fileSize);
            header('Content-Length: ' . ($end - $start + 1));
            fseek($file, $start);
            // 後續循環同前,但注意 chunkSize 不要超過剩餘長度
        }
    }
}

生產環境建議

  • 使用 X-Sendfile (Apache mod_xsendfile) 或 X-Accel-Redirect (Nginx) 將文件傳輸卸載到 Web Server,PHP 僅做權限檢查與限速邏輯(通過 limit_rate)。
  • 大文件建議啟用 readfile() 配合 stream_copy_to_stream() 避免 PHP 內存佔用。
  • 記錄下載日志(用戶、文件、IP、速度、完成狀態)便於審計。

總結

分塊輸出 + flush() + sleep() 是純 PHP 實現限速下載最簡單可靠的方案。理解緩衝區機制與 HTTP 協議頭,即可靈活控制下載體驗。

copyright © 萬盛學電腦網 all rights reserved