答案:通过解析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
<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中文网其它相关文章!