php强制下载文件代码强制浏览器不预览-php教程-PHP中文网

要让浏览器强制下载文件而不预览，核心做法是设置 http 响应头 content-disposition 为 attachment，并指定文件名。同时必须正确设置 content-type 和 content-length，最后输出文件内容并终止脚本执行。

php强制下载文件代码强制浏览器不预览

`Content-Disposition` 头部的具体作用是什么

该头部直接告诉浏览器如何处理响应体。设置为 attachment 时，浏览器会忽略文件类型匹配的内核预览机制（如 PDF、图片查看器），转而触发操作系统的“另存为”对话框或默认下载行为。如果省略此头部或设为 inline，浏览器会根据 Content-Type 尝试在标签页内渲染内容。

php强制下载文件代码强制浏览器不预览

header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="example.pdf"');
header('Content-Transfer-Encoding: binary');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . filesize($file));
cobuffer_clean();
readfile($file); 
exit;

上述代码中，application/octet-stream 是一种通用的二进制流类型，配合 attachment 能最大程度避免浏览器因猜测 MIME 类型而错误地尝试预览。使用 cobuffer_clean() 清除 PHP 缓冲区中的任何残留输出至关重要，否则会导致文件损坏或下载失败。exit 确保在发送完文件后不再执行后续逻辑。

如何防止缓存导致下载行为异常

浏览器可能会缓存之前获取的资源，导致再次访问相同 URL 时直接从缓存读取并预览，而非重新下载。通过设置特定的缓存控制头部可以强制浏览器每次都向服务器请求最新数据，并确保下载流程正常触发。

CDP浏览器大师

CDP浏览器大师：通过Chrome DevTools Protocol驱动已登录浏览器实现自动化任务，解决反爬封号、选择器失效、SPA路由难导航、固定sleep不准四大痛点。核心能力包括UA伪装、WebGL/Canvas指纹混淆、智能等待、动态选择器以及可视化调试。

下载

php强制下载文件代码强制浏览器不预览

header('Cache-Control: no-cache, no-store, max-age=0, must-revalidate');
header('Pragma: no-cache');
header('Expires: Wed, 11 Jan 1984 05:00:00 GMT');

no-cache 和 no-store 组合使用可禁止中间代理和客户端存储副本。must-revalidate 要求在使用过期缓存前必须验证其有效性。配合 Pragma: no-cache 兼容旧版 HTTP/1.0 客户端。这些设置确保了每次请求都会经过完整的下载流程，而不是被静默拦截。

当文件路径包含中文或特殊字符时会发生什么

如果 filename 参数中包含非 ASCII 字符（如中文），部分浏览器可能无法正确解析文件名，导致乱码或下载失败。这是因为 HTTP 头部默认使用 ISO-8859-1 编码，而现代浏览器支持 RFC 5987 定义的 UTF-8 编码格式。

为解决此问题，应使用 rawurlencode() 对文件名进行编码，并采用 filename*=UTF-8''... 的语法。例如：header('Content-Disposition: attachment; filename="report.pdf"; filename*=UTF-8'\'' . rawurlencode('报告.pdf') . '\'' );。这种写法同时提供了回退名称和 UTF-8 编码名称，确保在所有主流浏览器中都能正确显示文件名并触发下载。