在php中强制下载文件，核心做法是设置http响应头 content-disposition 为 attachment，并配合正确的文件名编码。具体实现时，需先调用 header() 函数发送 content-type、content-length 和 content-disposition，随后通过 readfile() 或类似函数输出文件内容。若文件名包含非ascii字符（如中文），必须使用 rfc 5987 标准进行编码，否则浏览器可能显示乱码或无法正确识别文件名。
Content-Disposition 头部的标准格式与关键参数是什么？
该头部用于指示浏览器如何处理响应内容，强制下载的关键在于将值设为 attachment。其基本语法为 Content-Disposition: attachment; filename="..."。其中，filename 参数指定下载后的默认文件名，而 filename* 参数则用于提供UTF-8编码的文件名以兼容现代浏览器。仅使用 filename 在处理中文文件名时存在兼容性风险，因此推荐同时提供两者以确保最佳效果。
<?php
$file = 'example.pdf';
$filename = '报告.pdf';
// 1. 设置 MIME 类型
header('Content-Type: application/octet-stream');
// 2. 设置文件大小
header('Content-Length: ' . filesize($file));
// 3. 设置 Content-Disposition
// 使用 filename* 处理 UTF-8 文件名 (RFC 5987)
// encoding: utf-8, language: '', encoded-filename
header('Content-Disposition: attachment; filename="' . basename($file) . '"; filename*=UTF-8' . urlencode($filename));
// 4. 清除缓冲区并输出文件
ob_clean();
flush();
readfile($file);
exit;
?>
上述代码首先获取目标文件的路径和期望的下载名称。接着，它设置了通用的二进制流类型 application/octet-stream 以确保浏览器不尝试预览。随后，通过 filesize() 计算文件大小并发送 Content-Length 头，这有助于浏览器显示下载进度条。最关键的是 Content-Disposition 的设置：它同时包含了标准的 filename 和 UTF-8 编码的 filename*。最后，ob_clean() 和 flush() 确保没有额外的空白字符被输出，readfile() 则将文件内容直接写入输出缓冲区，完成下载流程。
立即学习“PHP免费学习笔记（深入）”；
不同浏览器对 filename 和 filename* 的解析优先级如何？
现代浏览器遵循 RFC 6266 标准，当同时存在 filename 和 filename* 时，优先使用 filename* 中的 UTF-8 编码文件名。如果浏览器不支持 filename*，则会回退到 filename。若 filename 中包含非 ASCII 字符且未正确编码，部分旧版浏览器可能会截断文件名或显示乱码。因此，双参数策略是解决跨浏览器兼容性问题的最佳实践。
<?php
// 模拟不同浏览器的行为逻辑
function simulateBrowserBehavior($filename, $useFilenameStar) {
$resolvedName = '';
if ($useFilenameStar) {
// 现代浏览器：优先使用 filename*
$resolvedName = urldecode(str_replace("'", "", explode("'", $filename)[2]));
} else {
// 旧版浏览器：回退到 filename
// 若 filename 包含中文且未编码，可能出错
$resolvedName = $filename;
}
return $resolvedName;
}
$chineseName = '测试文件.txt';
echo "Modern Browser: " . simulateBrowserBehavior("UTF-8''" . urlencode($chineseName), true) . "\n";
echo "Old Browser: " . simulateBrowserBehavior($chineseName, false) . "\n";
?>
这段代码模拟了浏览器解析文件名的逻辑。在现代浏览器环境中，系统会提取 filename* 中经过 URL 编码的部分并进行解码，从而正确还原中文文件名。而在旧版浏览器中，由于不支持 filename*，系统直接使用 filename 的值。如果此时 filename 直接包含中文字符而未进行 ISO-8859-1 等兼容编码，可能会导致显示异常。这种差异解释了为什么在 PHP 实现中必须同时提供两种命名方式，以适应不同版本的客户端。
如果文件路径不存在或权限不足，Content-Disposition 还会生效吗？
即使设置了 Content-Disposition 头部，如果文件读取失败（如路径错误或权限不足），浏览器仍会接收到 HTTP 响应，但内容可能为空或报错信息。此时，下载行为取决于服务器返回的状态码和内容。如果 readfile() 失败，通常不会输出任何有效文件内容，浏览器可能显示“下载失败”或空白页面。因此，在设置下载头之前，务必验证文件的存在性和可读性，以避免无效请求。
