PHP分段下载文件教程

想要实现PHP分段下载文件，提升大文件下载体验吗？本文详细介绍了如何利用HTTP Range头实现断点续传下载功能。通过解析Range请求头，设置206 Partial Content状态码及Content-Range等关键响应头，结合fopen、fread流式读取文件内容，可以轻松实现文件的分段下载，支持暂停、恢复下载，并能实时输出数据流。本文还提供了完整的PHP示例代码，教你一步步实现高效、稳定的分段下载接口，让你的网站轻松应对大文件下载需求，优化用户体验。快来学习如何使用PHP实现断点续传下载吧！

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

在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() 强制输出缓冲区内容，实现“流式”传输。

$fp = fopen($filePath, 'rb');
$bufferSize = 8192; // 每次读取8KB
if ($range && isset($start)) {
fseek($fp, $start); // 跳转到起始位置
}
while (!feof($fp)) {
echo fread($fp, $bufferSize);
ob_flush();
flush(); // 实时发送到客户端
// 可选：防止超时
if (connection_status() != CONNECTION_NORMAL) {
break;
}
}
fclose($fp);

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

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

function serveFile($filePath) {
    if (!file_exists($filePath)) {
        header("HTTP/1.1 404 Not Found");
        exit;
    }
$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分段下载文件教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！