php 8.2 下载文件必须显式设置缓存头（如cache-control: no-store, no-cache, must-revalidate, max-age=0）、清空输出缓冲、流式传输大文件、rfc 5987 编码中文名，并确保头与流原子性生效。
PHP 8.2 下载服务器本地文件（即读取磁盘上的文件并推送给浏览器）时，缓存控制不是可选动作，而是必须显式处理的环节——否则浏览器可能复用旧响应、跳过重新请求，导致用户下载到过期或错误版本的文件。
为什么 download.php 响应默认不缓存反而更危险
很多人以为“不设缓存头就等于不缓存”，其实不然：readfile() 或 fpassthru() 输出后若没声明缓存策略，浏览器会按自身规则（比如基于 Last-Modified 或启发式算法）决定是否缓存。尤其当文件内容更新但修改时间未变，或 Nginx/Apache 启用了默认缓存模块时，用户极可能下载到陈旧副本。
- 必须主动设置
Cache-Control: no-store, no-cache, must-revalidate, max-age=0来禁止一切缓存行为 -
Pragma: no-cache和Expires: 0是对老版本 HTTP/1.0 客户端的兼容补丁，不能省略 - 如果业务允许“短时缓存”（如静态资源包），可改用
Cache-Control: public, max-age=3600，但需确保文件名带哈希或版本号，避免缓存击穿
download.php 必须在输出前清空所有缓冲区
一旦 PHP 已经输出过任何字符（哪怕是一个空格、BOM 或 echo ''），header() 就会失败，报错 Warning: Cannot modify header information - headers already sent。这不是 PHP 8.2 特有，但 8.2 对输出控制更严格（尤其开启 output_buffering=Off 时）。
- 开头加
ob_end_clean()，强制清掉之前所有已缓存输出（包括框架自动注入的空白） - 确认文件路径变量没被意外 echo/print，检查 include/require 的配置文件是否含尾随换行
- 用
headers_sent($file, $line)快速定位哪行代码提前输出了内容
大文件下载必须用流式传输 + 缓存头组合
用 readfile() 下载 >5MB 的文件，在 PHP 8.2 中极易触发 memory_limit 超限或 max_execution_time 中断，尤其当 opcache.enable_cli=1 且脚本被 CLI 方式调用时表现更不稳定。
- 改用
fopen($path, 'rb')+fread()分块读取（建议 8192 字节/次），配合fpassthru()或手动echo fread(...) - 务必在
fopen()前设置set_time_limit(0)和ignore_user_abort(true)，防止用户中途关闭页面导致进程僵死 - 缓存头必须在
fopen()之前发送，且Content-Length要精确等于filesize($path)，否则 Chrome/Firefox 会拒绝接受部分响应
中文文件名在 PHP 8.2 中要按 RFC 5987 编码
直接写 filename="报告.pdf" 在 Safari 和部分 Android 浏览器里会乱码；PHP 8.2 默认不自动转码，必须手动处理。
- 用
rawurlencode()编码文件名主体，再拼接filename*=UTF-8''{encoded}格式 - 同时保留传统
filename="fallback.pdf"作为降级兼容字段 - 别用
iconv()或mb_convert_encoding()直接转 ISO-8859-1——那在现代浏览器里基本失效
最易被忽略的是：缓存头和文件流必须原子性生效。哪怕只漏掉一个 Cache-Control，或 fopen() 后忘了 fclose()，都可能导致后续请求复用连接时拿到错误响应体。PHP 8.2 不会帮你兜底，它只按你写的 header 和流操作执行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
