通過 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) 防止用戶取消導致腳本中止留下臨時文件 |
// 簡易 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 不要超過剩餘長度
}
}
}
limit_rate)。readfile() 配合 stream_copy_to_stream() 避免 PHP 內存佔用。分塊輸出 + flush() + sleep() 是純 PHP 實現限速下載最簡單可靠的方案。理解緩衝區機制與 HTTP 協議頭,即可靈活控制下載體驗。