PHP文件下载需设响应头并输出内容:一用readfile适合中小文件;二用fpassthru控内存;三分块读取防溢出;四支持Range断点续传;五须校验路径防遍历攻击。

如果需要在PHP中实现文件下载功能,通常涉及设置正确的HTTP响应头并输出文件内容。以下是几种常见的实现方法:
一、使用readfile函数直接输出文件
该方法适用于小到中等大小的文件,通过readfile读取文件内容并直接发送给客户端,同时设置必要的响应头以触发浏览器下载行为。
1、设置Content-Type为application/octet-stream,强制浏览器不尝试解析而直接下载。
2、设置Content-Disposition头,指定文件名及下载方式为attachment。
立即学习“PHP免费学习笔记(深入)”;
3、设置Content-Length头,告知浏览器文件大小,便于显示进度。
4、调用readfile函数输出文件二进制流。
5、使用exit终止脚本执行,防止后续输出干扰下载流。
二、使用fpassthru配合fopen读取文件
该方法通过文件指针逐块读取并输出,内存占用更可控,适合对大文件做基础流式传输,同时保持响应头完整性。
1、使用fopen以二进制只读模式打开目标文件。
2、检查文件是否成功打开,若失败则返回404响应并退出。
3、设置Content-Type为application/octet-stream。
4、设置Content-Disposition头,其中filename字段需使用rawurlencode处理中文名。
5、设置Content-Transfer-Encoding为binary,并禁用输出缓冲。
6、调用fpassthru将文件指针内容直接写入输出缓冲区。
7、关闭文件指针并调用exit结束脚本。
三、分块读取大文件避免内存溢出
针对超大文件(如数百MB以上),一次性加载会耗尽内存,需采用分块读取方式,每次读取固定字节数并立即输出,确保低内存占用和稳定传输。
1、使用fopen以rb模式打开文件,获取文件大小并设置Content-Length响应头。
2、设置Content-Type为application/octet-stream,Content-Disposition含原始文件名。
3、禁用输出缓冲并设置implicit_flush为true。
4、定义每次读取的字节数(如8192字节)。
此代码么有依靠js文件实现的,而且大图和小图是分开的,这样用户在打开网页的时候能节约不少时间和流量 此代码实现方法也很简单,可以直接把index.html和images下面的文件拷贝到你需要运行的位置,然后保存即可,images下面的大图和小图按照你的需求来改,也可以给大图增加链接。
5、使用while循环配合fread读取数据块,每读一块即调用echo输出。
6、每次输出后调用flush和ob_flush强制刷新输出缓冲区。
7、循环结束后关闭文件句柄并调用exit。
四、支持断点续传的下载实现
该方法通过解析Range请求头,仅返回客户端所需的部分字节范围,满足大文件断点续传与多线程下载需求,需正确设置206 Partial Content状态码及相关头部。
1、获取文件路径并验证文件是否存在且可读。
2、获取文件大小,读取HTTP_RANGE头判断是否为范围请求。
3、若存在Range头,解析起始与结束位置,计算实际要返回的字节长度。
4、设置HTTP状态码为206 Partial Content,Content-Range头格式为bytes start-end/size。
5、设置Content-Length为本次传输的字节数,Content-Type与Content-Disposition保持常规设置。
6、使用fseek定位文件指针至start位置,循环fread并echo输出指定长度数据。
7、完成输出后关闭文件并exit。
五、安全校验与路径防护处理
为防止目录遍历攻击(如../etc/passwd),必须对用户传入的文件路径进行严格过滤与规范化校验,确保仅允许访问预设目录下的合法文件。
1、使用basename提取请求参数中的文件名,丢弃路径部分。
2、将预设安全目录路径与basename拼接,生成完整绝对路径。
3、使用realpath获取标准化路径,并检查其是否仍位于安全目录内。
4、验证文件是否存在、是否为普通文件、是否可读。
5、检查文件扩展名是否在白名单中(如pdf、zip、txt等)。
6、若任一校验失败,则返回403 Forbidden状态并退出。
7、校验通过后,继续执行对应下载逻辑(如方法一或二)。










