PHP实现文件下载断点续传详解

PHP实现文件下载断点续传详解

什么是文件下载断点续传？

文件下载一般是通过HTTP协议实现的。如果需要下载一个很大的文件，那么下载时间可能会很漫长，因为如果中途出现了网络问题等原因，几乎是不可能重新从头开始下载文件的。而文件下载的断点续传就是可以让用户在之前下载失败、中断的地方重新开始下载，而不是从头再来。

PHP如何实现文件下载断点续传？

1. 设置文件下载的请求头(Header)

文件下载的关键在于HTTP的Header设置。通过在请求头中设置Range字段，即可控制从哪里开始下载文件，这就是实现断点续传的关键。

以下是设置请求头的示例：

header('Content-type: application/octet-stream');
header('Content-Disposition: attachment; filename="'.$fileName.'"');
header('Accept-Ranges: bytes');
if(isset($_SERVER['HTTP_RANGE'])) {
    header('HTTP/1.1 206 Partial Content');
    list($name, $range) = explode("=", $_SERVER['HTTP_RANGE']);
    list($begin, $end) = explode("-", $range);
    if($end == 0 || !$end) {
        $end = $fileSize - 1;
    }
    header("Content-Length: " . ($end - $begin + 1));
    header("Content-Range: bytes $begin-$end/$fileSize");
    fseek($file, $begin);
    while(!feof($file)) {
        print(fread($file, 1024*8));
        flush();
    }
} else {  
    header("Content-Length: ".$fileSize);
    readfile($filePath);
}

1. 处理中断文件下载的情况

如果文件下载中途出现了问题而中断，我们需要保存已经下载的文件的位置。这可以通过将已经下载的字节数存储在session或者cookie中实现。

以下是一个示例：

$lastProgress = 0;  
$file = fopen($filePath, "rb");  
if(isset($_SERVER['HTTP_RANGE'])) {  
    $range = str_replace("bytes=", "", $_SERVER['HTTP_RANGE']);  
    fseek($file, $range);  
    $lastProgress = $range;  
    header("HTTP/1.1 206 Partial Content");  
} else if (isset($_SERVER['HTTP_IF_RANGE']) && $_SERVER['HTTP_IF_RANGE'] == $lastModifiedReference) {
    header("HTTP/1.1 304 Not Modified");  
    return;  
} else {                  
    header("Content-Length: " . $fileSize);  
    header("HTTP/1.1 200 OK");  
} 

while(!feof($file)) { 
    set_time_limit(0); 
    $contents = fread($file, 8192); 
    $lastProgress += 8192; 
    echo $contents; 
    ob_flush(); 
    flush(); 
} 

fclose($file); 

1. 处理文件名中的中文和空格

当文件名中包含中文和空格时，浏览器不会正确地解析下载文件的文件名，这会导致文件名出现乱码或者无法下载。因此，我们需要对文件名进行URL编码，以便于浏览器能够正确地解析。

以下是示例代码：

$fileName = urlencode($fileName);
header("Content-Disposition: attachment; filename={$fileName}");

这样设置后，文件名中的空格会被转化成%20，中文会被转换成%XX的形式，这样浏览器就可以正确地解析文件名了。

示例说明

以下是示例代码：

$fileInfo = array(
    'filepath' => 'test.mp4',  // 文件路径
    'filesize' => filesize($file),  // 文件大小
    'filename' => 'test.mp4',  // 文件名
);

$lastModifiedReference = gmdate("D, d M Y H:i:s T", filemtime($fileInfo['filepath']));

header("Cache-Control: public");
header("Content-Type: audio/mpeg");
header("Content-Transfer-Encoding: binary");
header("Content-Length:" . $fileInfo['filesize']);
header("Content-Disposition: attachment; filename=" . $fileInfo['filename']);

if (isset($_SERVER['HTTP_RANGE'])) {
    header("HTTP/1.1 206 Partial Content");
    $range = substr($_SERVER['HTTP_RANGE'], strpos($_SERVER['HTTP_RANGE'], '=') + 1);
    $range = explode("-", $range);
    $start = intval($range[0]);
    $end = intval($range[1]);
    $length = $end - $start + 1;
    fseek($handle, $start);
    header("Content-Range: bytes $start-$end/" . $fileInfo['filesize']);
    header("Content-Length: $length");

    while (!feof($handle)) {
        echo fread($handle, 8192);
        flush();
    }
    fclose($handle);

} else {
    header("Content-Length:" . $fileInfo['filesize']);
    readfile($file);
}

以上是一个简单的基于PHP实现文件下载的断点续传功能的示例，可供参考。