PHP文件下载实现代码示例

本文深入讲解了PHP实现安全、高效文件下载的五种核心方法：从适合中小文件的readfile直传，到内存可控的fpassthru流式输出，再到应对超大文件的分块读取机制，以及支持断点续传与多线程下载的Range请求处理，最后强调了至关重要的路径校验与安全防护策略——包括防目录遍历、文件白名单、路径规范化等关键措施，帮助开发者在真实项目中兼顾功能性、性能与安全性，避免常见漏洞与崩溃风险。

如果需要在PHP中实现文件下载功能，通常涉及设置正确的HTTP响应头并输出文件内容。以下是几种常见的实现方法：

一、使用readfile函数直接输出文件

该方法适用于小到中等大小的文件，通过readfile读取文件内容并直接发送给客户端，同时设置必要的响应头以触发浏览器下载行为。

1、设置Content-Type为application/octet-stream，强制浏览器不尝试解析而直接下载。

2、设置Content-Disposition头，指定文件名及下载方式为attachment。

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字节）。

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、校验通过后，继续执行对应下载逻辑（如方法一或二）。

到这里，我们也就讲完了《PHP文件下载实现代码示例》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！