PHP实现文件下载与断点续传技巧

一分耕耘，一分收获！既然打开了这篇文章《PHP实现文件强制下载与断点续传方法》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

通过设置HTTP响应头可强制浏览器下载文件并支持断点续传。使用Content-Disposition: attachment触发下载，结合Range请求头实现断点续传，通过解析HTTP_RANGE计算起始位置，返回206状态码及Content-Range信息，分块读取文件避免内存溢出，同时建议将文件存于Web目录外、校验权限、过滤文件名以确保安全。

在Web开发中，有时需要让用户下载服务器上的文件，而不是在浏览器中直接打开。PHP可以通过设置合适的HTTP响应头来实现强制浏览器下载文件，同时还可以支持断点续传功能，提升大文件下载体验。

强制浏览器下载文件

默认情况下，浏览器可能会尝试在内部打开某些文件类型（如PDF、图片、文本等）。通过设置Content-Disposition: attachment，可以强制浏览器将文件作为下载处理。

示例代码：

$file_path = 'path/to/your/file.pdf';
$file_name = 'download.pdf';
if (file_exists($file_path)) {
// 清除缓冲区，防止输出干扰
ob_clean();
flush();
// 设置响应头
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $file_name . '"');
header('Content-Length: ' . filesize($file_path));
header('Content-Transfer-Encoding: binary');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');

// 读取并输出文件内容
readfile($file_path);
exit;
} else {
http_response_code(404);
echo "文件未找到。";
}

关键说明：

• Content-Type: application/octet-stream 表示任意二进制流，浏览器不会尝试解析。
• Content-Disposition: attachment 触发下载对话框。
• 使用ob_clean()和flush()避免因前面输出导致下载失败。

支持断点续传

对于大文件，用户可能因网络中断需要恢复下载。HTTP协议通过Range请求头支持断点续传，PHP可以通过解析该头信息返回部分内容。

支持断点续传的完整示例：

function download_with_resume($file_path, $file_name) {
    if (!file_exists($file_path)) {
        http_response_code(404);
        echo "文件不存在。";
        return;
    }
$size = filesize($file_path);
$start = 0;
$end = $size - 1;
$length = $size;

// 检查是否有 Range 请求头
if (isset($_SERVER['HTTP_RANGE'])) {
    preg_match('/bytes=(\d+)-(\d*)/', $_SERVER['HTTP_RANGE'], $matches);
    $start = intval($matches[1]);

    if (!empty($matches[2])) {
        $end = intval($matches[2]);
    }

    // 计算本次传输长度
    $length = $end - $start + 1;

    // 发送 206 Partial Content 状态码
    http_response_code(206);
    header("Content-Range: bytes $start-$end/$size");
}

// 发送标准头
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $file_name . '"');
header('Accept-Ranges: bytes');
header("Content-Length: $length");
header("Content-Transfer-Encoding: binary");

// 打开文件，跳转到起始位置
$fp = fopen($file_path, 'rb');
fseek($fp, $start);

// 分段输出，避免内存溢出
while ($length > 0 && !feof($fp)) {
    $read_size = min($length, 8192);
    $data = fread($fp, $read_size);
    echo $data;
    flush();
    $length -= strlen($data);
}

fclose($fp);
exit;
}
// 调用函数
download_with_resume('path/to/large-file.zip', 'large-file.zip');

断点续传要点：

• 检查HTTP_RANGE头判断是否为断点请求。
• 返回206 Partial Content状态码表示部分响应。
• 使用Content-Range告知客户端数据范围。
• 逐块读取文件，适合大文件传输。

安全注意事项

直接暴露文件路径存在风险，建议采取以下措施：

• 将文件存放在Web根目录之外，避免直接访问。
• 对下载请求进行权限验证（如登录检查、token校验）。
• 过滤文件名，防止路径穿越（如../）。
• 限制可下载的文件类型或路径。

基本上就这些。实现文件下载不复杂，但要兼顾兼容性、性能和安全。

今天关于《PHP实现文件下载与断点续传技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！