PHP 8.2怎么实现上传文件下载支持断点续传？完整代码实现-php教程-PHP中文网

PHP 8.2 本身不直接提供断点续传功能，但可通过正确处理 HTTP Range 请求（返回 206 状态码、Content-Range 头等）配合客户端实现标准断点续传，代码需校验路径、流式输出并遵循 RFC 7233。

php 8.2怎么实现上传文件下载支持断点续传？完整代码实现

PHP 8.2 本身不直接提供“断点续传下载”功能，但可以通过正确设置 HTTP 响应头、读取文件指定字节范围（Range 请求）、配合客户端（如浏览器或下载工具）实现标准的 HTTP Range Requests 下载，从而支持断点续传。

关键点不是 PHP “主动续传”，而是：服务端识别客户端发来的 Range: bytes=xxx-yyy 请求，只返回对应字节段，并返回 206 Partial Content 状态码和正确响应头。只要客户端（如 wget、curl、支持断点的前端下载库）发起带 Range 的请求，服务端能响应，就天然支持断点续传。

✅ 前提条件与注意事项

确保你的 PHP 运行环境满足以下条件：

Web 服务器（Nginx/Apache）未强制禁用 Range 头（如 Nginx 默认支持；Apache 需启用 mod_headers 和 mod_mime）
上传的文件已存于服务器可读路径（如 /var/www/uploads/xxx.zip），且 PHP 有读取权限
不要用 readfile() 直接输出大文件 —— 它无法按需截取字节段，必须手动控制输出
务必校验文件路径，防止目录遍历攻击（../）

? 完整安全的下载接口代码（PHP 8.2）

保存为 download.php，通过 ?file=xxx.zip 访问（推荐配合 token 或登录态校验）：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

<?php // download.php —— 支持断点续传的文件下载（PHP 8.2 兼容）
$uploadDir = __DIR__ . '/uploads/'; // ✅ 上传目录绝对路径，不可写在 Web 可访问根下
$fileName = $_GET['file'] ?? '';
<p>// 1️⃣ 安全校验：白名单 + 路径规范化 + 防遍历
if (empty($fileName) || !is_string($fileName)) {
http_response_code(400);
exit('Invalid file parameter');
}<p>// 只允许字母、数字、下划线、短横线、点号；禁止路径分隔符
if (!preg<em>match('/^[a-zA-Z0-9</em>.-]+$/', $fileName)) {
http_response_code(400);
exit('Illegal filename');
}</p><p>$filePath = $uploadDir . $fileName;</p><p>if (!is_file($filePath) || !is_readable($filePath)) {
http_response_code(404);
exit('File not found or inaccessible');
}</p><p>// 2️⃣ 获取文件信息
$size = filesize($filePath);
$fm = fopen($filePath, 'rb');
if (!$fm) {
http_response_code(500);
exit('Cannot open file');
}</p><p>// 3️⃣ 检查是否为 Range 请求
$range = '';
if (isset($_SERVER['HTTP_RANGE']) && preg_match('/^bytes=(\d+)-(\d+)?$/i', $_SERVER['HTTP_RANGE'], $matches)) {
$range = $_SERVER['HTTP_RANGE'];
$start = (int)$matches[1];
$end   = isset($matches[2]) ? (int)$matches[2] : $size - 1;</p><pre class="brush:php;toolbar:false;">// 校验范围合法性
if ($start = $size || $end >= $size || $end <p>} else {
$start = 0;
$end   = $size - 1;
}</p><p>// 4️⃣ 设置响应头（核心：支持断点的关键）
$length = $end - $start + 1;</p><p>header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . rawurlencode($fileName) . '"');
header('Accept-Ranges: bytes');
header('Content-Length: ' . $length);</p><p>if ($range) {
http_response_code(206); // Partial Content
header("Content-Range: bytes $start-$end/$size");
} else {
http_response_code(200); // OK
}</p><p>// 5️⃣ 输出文件片段（流式，避免内存溢出）
fseek($fm, $start);
$bufferSize = 8192;
while ($length > 0 && !feof($fm)) {
$read = min($bufferSize, $length);
$data = fread($fm, $read);
if ($data === false || strlen($data) === 0) break;
echo $data;
$length -= strlen($data);
flush(); // 确保及时输出给客户端
}
fclose($fm);
exit;
?></p>

? 如何测试断点续传？

使用 curl 模拟 Range 请求验证逻辑是否生效：

首次下载前 1024 字节：curl -H "Range: bytes=0-1023" -v http://yoursite/download.php?file=test.pdf → 应返回 206 和 Content-Range
跳过前 5MB 继续下载：curl -H "Range: bytes=5242880-" -o part2.bin http://yoursite/download.php?file=test.zip
用支持断点的工具（如 IDMan、Motrix、aria2）下载该 URL，中断后重试，会自动发 Range 请求

? 生产环境增强建议

权限控制：在开头加入用户登录态或 JWT token 校验（例如检查 $_SESSION['user_id'] 或解析 Bearer Token）
限速/限频：对高频请求做 IP 或用户级限流（可用 Redis 计数）
日志记录：记录下载行为（文件名、用户、IP、时间、字节数）便于审计
大文件优化：超大文件（>1GB）建议用 X-Sendfile（Nginx）或 X-Accel-Redirect（Apache）交由 Web 服务器处理，PHP 只做鉴权
缓存策略：添加 Cache-Control: public, max-age=3600 提升 CDN 缓存效率（注意敏感文件勿缓存）