如何用FPDF设置PDF下载文件名？解决浏览器字符替换异常

我在用FPDF生成PDF文件时，遇到了个头疼的问题：明明代码里设置的下载文件名是Overview: 2017/2018，调用$pdf->Output( 'D', $pdfTitle, true );后，浏览器保存时自动把它改成了Overview_ 2017_2018，冒号和斜杠都被替换成了下划线。我的PHP文件是UTF-8编码的，查了FPDF相关文档后，我有两个疑问：

1. 如何确保下载名称与PHP代码中设置的一致？ #

要解决这个问题，我们需要绕过FPDF自动处理文件名的逻辑，手动设置HTTP响应头来指定下载文件名，同时兼顾不同浏览器和操作系统的兼容性。

具体做法如下：

• 先让FPDF把PDF内容输出为字符串（而非直接触发下载），用'S'参数调用Output方法；
• 然后设置兼容新旧浏览器的HTTP响应头：

$pdfTitle = 'Overview: 2017/2018';
// 生成PDF内容到字符串变量
$pdfContent = $pdf->Output('S');

// 处理文件名编码，适配RFC 5987标准（支持UTF-8文件名）
$encodedFilename = urlencode($pdfTitle);
$encodedFilename = str_replace('+', '%20', $encodedFilename);

// 设置HTTP响应头
header('Content-Type: application/pdf');
// 同时配置兼容旧浏览器的filename和现代浏览器的filename*参数
header('Content-Disposition: attachment; filename="' . $pdfTitle . '"; filename*=UTF-8\'\'' . $encodedFilename);
header('Content-Length: ' . strlen($pdfContent));

// 输出PDF内容
echo $pdfContent;
exit;

这样设置后，现代浏览器会优先识别filename*参数的UTF-8编码文件名，旧浏览器则回退使用filename参数，能最大程度保留你想要的文件名格式。不过要注意：如果文件名包含操作系统禁止的字符（比如Windows的:、/），部分浏览器或系统还是会自动替换，但这已经是最接近需求的方案了。

2. 导致名称被修改的底层原因是什么？ #

这个问题是FPDF内部处理+浏览器/操作系统限制共同作用的结果：

• FPDF的自动清理逻辑：FPDF的Output方法在处理文件名时，会自动替换它认为“不安全”或不符合HTTP规范的特殊字符（比如冒号、斜杠），将其替换为下划线，这是最直接的触发原因；
• HTTP协议与浏览器兼容性：早期HTTP协议对文件名的处理没有统一标准，不同浏览器对Content-Disposition头里的特殊字符解析规则不同，为避免解析错误，很多浏览器会主动替换特殊字符；
• 操作系统文件名限制：不同操作系统对文件名有严格字符限制（比如Windows禁止使用:、/、*等字符），浏览器为了让下载的文件能正常保存到本地，会自动替换掉这些系统不允许的字符。

内容的提问来源于stack exchange，提问作者Rob Monhemius