在php中实现中文名文件的强制下载，核心在于正确设置http响应头中的`content-disposition`字段。推荐使用rfc 5987标准（即`filename*=utf-''...`格式），它能确保现代浏览器正确解析非ascii字符的文件名。具体做法是调用`header()`函数，将文件名进行url编码后拼接进头部，并配合`readfile()`输出文件内容，这样即可触发浏览器的下载行为。
header()如何构造正确的下载头
要构造符合RFC 5987标准的下载头，需要获取原始文件名，使用rawurlencode()对其进行编码，然后将其赋值给filename*参数。同时为了兼容旧版IE浏览器，通常还需要提供一个经过Base64编码的filename参数作为降级方案。这种双参数策略能覆盖绝大多数浏览器环境。
<?php
// 假设这是我们要下载的中文名文件
$originalFilename = '测试文档.pdf';
$fileSize = filesize($originalFilename);
// 1. 构建 RFC 5987 格式的 filename* (推荐)
// rawurlencode 会将中文转为 %XX%XX 格式
$encodedFilename = rawurlencode($originalFilename);
$rfc5987Header = "filename*=UTF-8''" . $encodedFilename;
// 2. 构建 Base64 格式的 filename (兼容 IE/旧版浏览器)
// mb_convert_encoding 转 UTF-8, base64_encode 编码
$b64Filename = base64_encode(mb_convert_encoding($originalFilename, 'UTF-8', 'auto'));
$ieCompatibleHeader = "filename=\"" . $b64Filename . "\"";
// 3. 发送 HTTP 头
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; ' . $rfc5987Header . ', ' . $ieCompatibleHeader);
header('Content-Length: ' . $fileSize);
header('Cache-Control: no-cache');
// 4. 输出文件内容
readfile($originalFilename);
exit;
?>
上述代码首先计算文件大小以设置Content-Length，避免流式传输问题。接着分别生成两种编码格式的头信息。最后通过readfile()直接读取文件并输出到缓冲区，exit确保不再执行后续代码。这种方式简单且高效，适用于大多数Web服务器环境。
立即学习“PHP免费学习笔记（深入）”；
不同浏览器对编码头的解析差异
尽管RFC 5987是现代标准，但实际开发中仍需考虑浏览器的兼容性差异。Chrome、Firefox和Safari等现代浏览器优先解析filename*=部分，而Internet Explorer 10及以下版本则完全忽略该部分，仅识别filename=中的Base64编码内容。因此，必须同时提供两者以确保跨平台一致性。
<?php
function downloadFileWithFallback($filePath) {
if (!file_exists($filePath)) {
http_response_code(404);
echo 'File not found';
return;
}
$filename = basename($filePath);
// 检测用户代理以决定优先级（可选优化）
$ua = $_SERVER['HTTP_USER_AGENT'];
$isIE = preg_match('/MSIE [1-9]/i', $ua) || preg_match('/Trident/i', $ua);
// 始终发送两个头，让浏览器自行选择
$utf8Encoded = rawurlencode($filename);
$base64Encoded = base64_encode($filename);
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $base64Encoded . '"; filename*=UTF-8\'\'' . $utf8Encoded . '');
header('Content-Length: ' . filesize($filePath));
readfile($filePath);
}
// 调用示例
downloadFileWithFallback('./my_file.txt');
?>
在实际应用中，建议始终同时发送filename和filename*，而不是根据UA动态选择。因为现代浏览器虽然支持RFC 5987，但在某些特殊配置下可能回退到旧标准。同时发送两者可以让浏览器内部逻辑决定使用哪一个，从而获得最佳兼容性。此外，注意filename*的值中不应包含引号，而filename的值通常需要包裹在双引号中以防止空格截断。
当文件名包含特殊字符时如何处理
如果文件名中包含空格、括号或中文标点等特殊字符，直接使用basename()获取后仍需谨慎处理。例如，文件名“报告 (2023).pdf”在URL编码后会变成“报告%20(2023).pdf”。此时，rawurlencode()会保留括号和点号，但将空格转换为%20。对于Base64编码，这些字符会被完整编码为字符串的一部分，不会丢失信息。关键在于确保Content-Disposition头部的语法结构不被破坏，特别是分号和等号的使用。
