在php中实现强制下载文件时，文件名若包含中文或特殊字符，必须使用rawurlencode()进行编码以符合http规范。具体做法是设置content-disposition响应头，将文件名包裹在双引号中并赋值给filename="..."参数，同时配合content-type和content-length头确保浏览器触发下载行为而非直接预览。
rawurlencode()对中文文件名的编码结果是什么
rawurlencode()会将中文字符转换为UTF-8字节序列的十六进制URL编码形式，例如“测试.txt”会被编码为“%E6%B5%8B%E8%AF%95.txt”。这种编码方式确保了文件名在HTTP头部传输时不会因非ASCII字符导致解析错误，且能被现代浏览器正确还原。
<?php
$file = 'test.pdf';
$path = '/var/www/files/' . $file;
if (file_exists($path)) {
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . rawurlencode($file) . '"');
header('Content-Length: ' . filesize($path));
readfile($path);
exit;
}
?>
上述代码针对本地存在的test.pdf文件，通过readfile()输出内容。预期结果是浏览器弹出下载对话框，保存的文件名为“test.pdf”，且服务器端无额外日志输出。若文件不存在，则不发送任何内容，仅结束脚本。
立即学习“PHP免费学习笔记（深入）”；
为什么需要同时设置Content-Type和Content-Length
设置Content-Type: application/octet-stream告诉浏览器该资源是二进制流，避免根据扩展名尝试预览；设置Content-Length让浏览器知道文件大小，支持断点续传和进度条显示。缺少任一头部可能导致下载失败或体验不佳。
<?php
// 模拟不同文件类型的处理逻辑
$files = [
'image.png' => 'image/png',
'video.mp4' => 'video/mp4',
'doc.docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
];
foreach ($files as $name => $type) {
// 实际应用中应检查文件是否存在
// header('Content-Type: ' . $type);
echo "Filename: " . rawurlencode($name) . " -> Type: " . $type . "\n";
}
?>
此段代码展示了针对不同MIME类型文件的处理思路。虽然示例中未实际输出文件，但明确了Content-Type应根据文件实际类型动态设置，而Content-Disposition中的文件名始终需经rawurlencode()处理。这确保了无论文件类型如何，下载行为均能正确触发。
当文件名包含空格或特殊符号时如何处理
若文件名如“my file (1).txt”包含空格和括号，rawurlencode()会将其编码为“my%20file%20(1).txt”。浏览器接收到此编码后的文件名后，会自动解码并显示为原始名称。这是RFC 5987标准推荐的做法，兼容性好且无需额外配置。
