PHP如何实现分段下载文件_PHP实时输出实现文件分段下载-php教程-PHP中文网

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

爱谁谁

发布： 2025-10-09 20:06:02

原创

791人浏览过

答案：通过解析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. 实时输出文件内容（边读边发）

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

立即学习“PHP免费学习笔记（深入）”；

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

核心读取逻辑：

$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>

登录后复制

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中文网其它相关文章！