PHP如何实现分段下载文件_PHP实时输出实现文件分段下载

答案:通过解析HTTP Range头实现分段下载,设置206状态码及Content-Range响应头,结合fopen、fread流式输出文件内容,支持断点续传。

php如何实现分段下载文件_php实时输出实现文件分段下载

在PHP中实现文件的分段下载(也叫断点续传下载),主要是通过HTTP请求头中的 Range 字段来控制文件部分内容的读取和传输。结合适当的响应头设置,可以让浏览器或客户端支持暂停、恢复下载,并能实时输出数据流,提升大文件下载体验。

1. 检测请求是否包含Range头

客户端在请求分段下载时,会发送 Range: bytes=0-1023 这样的请求头。服务器需解析该头信息,判断是否为分段请求。

示例代码:

$range = isset($_SERVER['HTTP_RANGE']) ? $_SERVER['HTTP_RANGE'] : null;
if ($range) {
    // 格式:bytes=0-1023 或 bytes=500-
    preg_match('/bytes=(/d*)-(/d*)/', $range, $matches);
    $start = intval($matches[1]);
    $end = isset($matches[2]) && $matches[2] !== '' ? intval($matches[2]) : null;
}
登录后复制

2. 设置正确的响应头

根据是否有Range头,返回不同的状态码和响应头。如果是分段请求,使用 206 Partial Content 状态码。

关键响应头设置:

  • Content-Length:当前传输的数据长度
  • Content-Range:格式为 bytes start-end/total
  • Accept-Ranges: bytes:告知客户端支持字节范围请求
  • Content-Type: application/octet-stream:通用二进制流类型
header('Accept-Ranges: bytes');
if ($range) {
    header('HTTP/1.1 206 Partial Content');
    header("Content-Range: bytes $start-$end/$fileSize");
    header("Content-Length: " . ($end ? $end - $start + 1 : $fileSize - $start));
} else {
    header('HTTP/1.1 200 OK');
    header("Content-Length: $fileSize");
}
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($filePath) . '"');
登录后复制

3. 实时输出文件内容(边读边发)

使用 fopenfread 分块读取文件,配合 ob_flush()flush() 强制输出缓冲区内容,实现“流式”传输。

核心读取逻辑:

$fp = fopen($filePath, 'rb');
$bufferSize = 8192; // 每次读取8KB
<p>if ($range && isset($start)) {
fseek($fp, $start); // 跳转到起始位置
}</p><p>while (!feof($fp)) {
echo fread($fp, $bufferSize);
ob_flush();
flush(); // 实时发送到客户端
// 可选:防止超时
if (connection_status() != CONNECTION_NORMAL) {
break;
}
}</p><p>fclose($fp);</p><div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/viitor%E5%AE%9E%E6%97%B6%E7%BF%BB%E8%AF%91"><img src="https://img.php.cn/upload/ai_manual/000/000/000/175680003823895.png" alt="ViiTor实时翻译"></a>
                        <div class="aritcle_card_info">
                            <a href="/ai/viitor%E5%AE%9E%E6%97%B6%E7%BF%BB%E8%AF%91">ViiTor实时翻译</a>
                            <p>AI实时多语言翻译专家!强大的语音识别、AR翻译功能。</p>
                            <div class="">
                            <img src="/static/images/card_xiazai.png" alt="ViiTor实时翻译">
                            <span>116</span>
                            </div>
                        </div>
                        <a href="/ai/viitor%E5%AE%9E%E6%97%B6%E7%BF%BB%E8%AF%91" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="ViiTor实时翻译">
                        </a>
                        </div>
登录后复制

4. 完整示例:支持断点续传的下载脚本

整合以上步骤,实现一个完整可用的分段下载接口。

function serveFile($filePath) {
    if (!file_exists($filePath)) {
        header("HTTP/1.1 404 Not Found");
        exit;
    }
<pre class='brush:php;toolbar:false;'>$fileSize = filesize($filePath);
$start = 0;
$end = $fileSize - 1;

$range = $_SERVER['HTTP_RANGE'] ?? null;
if ($range) {
    preg_match('/bytes=(/d*)-(/d*)/', $range, $matches);
    $start = intval($matches[1]);
    $end = isset($matches[2]) && $matches[2] !== '' ? intval($matches[2]) : $fileSize - 1;
    $end = min($end, $fileSize - 1);
}

$length = $end - $start + 1;

header('Accept-Ranges: bytes');
if ($range) {
    header('HTTP/1.1 206 Partial Content');
    header("Content-Range: bytes $start-$end/$fileSize");
} else {
    header('HTTP/1.1 200 OK');
}
header("Content-Length: $length");
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($filePath) . '"');

$fp = fopen($filePath, 'rb');
if ($start > 0) {
    fseek($fp, $start);
}

$bufferSize = 8192;
$sent = 0;
while ($sent < $length && !feof($fp)) {
    $data = fread($fp, min($bufferSize, $length - $sent));
    echo $data;
    $sent += strlen($data);
    ob_flush();
    flush();
    if (connection_aborted()) break;
}

fclose($fp);
登录后复制

}

// 调用
serveFile(‘/path/to/large-file.zip’);

基本上就这些。只要正确处理Range头、设置响应头、逐块输出,就能实现高效的分段下载功能。注意生产环境还需增加安全校验(如权限验证、路径过滤等)。

以上就是PHP如何实现分段下载文件_PHP实时输出实现文件分段下载的详细内容,更多请关注php中文网其它相关文章!

https://www.php.cn/faq/1599016.html

发表回复

Your email address will not be published. Required fields are marked *