通过设置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'; <p>if (file_exists($file_path)) { // 清除缓冲区,防止输出干扰 ob_clean(); flush();</p><pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">// 设置响应头 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可以通过解析该头信息返回部分内容。
支持断点续传的完整示例:
一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具,由深耕视频行业18年的一览科技研发推出。
41 function download_with_resume($file_path, $file_name) { if (!file_exists($file_path)) { http_response_code(404); echo "文件不存在。"; return; } <pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">$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文件下载怎么实现_PHP强制下载文件与断点续传的详细内容,更多请关注中文网其它相关文章!
微信扫一扫打赏
支付宝扫一扫打赏
