PHP文件下载需五步实现：一、设Content-Disposition等响应头强制下载；二、用中间件校验用户权限；三、生成带时效与HMAC签名的临时链接；四、流式分块输出防内存溢出；五、基于Redis限频限并发。
当用户请求下载文件时，PHP框架需要正确设置HTTP响应头并输出文件内容，同时确保仅授权用户可访问受保护资源。以下是实现文件下载响应与权限控制的具体步骤：
一、使用响应头强制浏览器下载文件
通过设置Content-Disposition为attachment，可避免浏览器直接渲染文本、图片等类型文件，转而触发下载行为。该方法适用于公开或基础权限校验后的文件分发。
1、在控制器中读取目标文件路径，确认文件存在且可读。
2、调用header()函数设置Content-Type为application/octet-stream，以通用二进制流类型响应。
立即学习“PHP免费学习笔记（深入）”；
3、设置Content-Disposition头，其中filename参数指定下载时的默认文件名，需对中文名进行RFC 5987编码处理。
4、设置Content-Length头，传入文件大小，便于浏览器显示下载进度。
5、关闭输出缓冲，调用readfile()直接输出文件流，并立即终止脚本执行。
二、基于中间件拦截未授权下载请求
在框架路由到达控制器前，通过中间件验证当前用户是否具备下载权限。该方式将权限逻辑与业务逻辑解耦，适用于角色/权限系统已集成的项目。
1、定义中间件类，在handle方法中获取请求URL中的文件标识（如ID或哈希路径）。
2、查询数据库或缓存，检查当前登录用户的ID是否存在于该文件的白名单中，或是否属于拥有download权限的角色组。
3、若校验失败，返回403状态码并输出拒绝访问：您无权下载此文件提示信息。
4、若校验通过，调用$next($request)放行至后续处理流程。
三、生成带时效与签名的一次性下载链接
为防止文件URL被非法传播，服务端生成包含时间戳和HMAC签名的临时链接，客户端仅在有效期内可凭此链接完成下载，提升安全性。
1、拼接原始路径、过期时间戳（如time() + 3600）及随机盐值构成待签名字符串。
2、使用配置密钥对字符串执行hash_hmac('sha256', $data, $secret)，截取前16位作为签名片段。
3、将文件路径、过期时间、签名组合为URL查询参数，例如/download?path=report.pdf&expires=1735689200&sig=a1b2c3d4e5f67890。
4、在下载入口控制器中解析参数，验证当前时间未超expires值，并重新计算签名比对，不一致则返回链接已失效或被篡改。
四、使用流式响应避免内存溢出
对于大文件（如视频、压缩包），直接readfile()可能引发内存耗尽。采用分块读取+flush机制，以固定缓冲区逐段输出，降低服务器资源压力。
1、打开文件句柄，使用fopen($filepath, 'rb')以二进制只读模式加载。
2、设置缓冲区大小为8192字节，循环调用fread()读取并echo输出，每次后调用ob_flush()和flush()确保数据实时发送。
3、在每轮输出前检查客户端连接是否断开，使用connection_status()判断，若为0则中断传输。
4、全部传输完毕后调用fclose()释放句柄，并终止脚本运行。
五、限制下载频次与并发数
防止恶意高频请求占用带宽或拖垮服务，需在应用层记录用户/IP维度的下载行为，实施速率限制。
1、使用Redis存储键如download:ip:192.168.1.100，值为时间窗口内请求次数，过期时间设为60秒。
2、每次下载请求前执行INCR命令递增计数，若返回值大于设定阈值（如5次/分钟），则拒绝响应并返回操作过于频繁，请稍后再试。
3、对登录用户，可改用download:user:12345为键，结合用户ID实现更精准限流。
4、在成功响应后不重置计数器，仅依赖Redis自动过期机制清理历史记录。
