使用PHP实现PDF文件下载

先聊一个很实际的需求：网站后台生成了PDF文件，或者你想让用户下载一份产品手册，但浏览器总是不给面子，直接在新标签页里把PDF打开。明明想让人下载，结果人家看了一眼就关掉了。其实强制下载PDF文件并不复杂，下面拆解两种最常用的方法，顺便把容易踩的坑也点出来。

方法一：修改.htaccess文件（Apache配置）

如果你用的是Apache服务器，并且所有PDF文件都希望强制下载，那直接在站点根目录下动一动.htaccess文件就搞定了。不需要改任何PHP代码，一劳永逸。

找到.htaccess文件（如果没有，新建一个），加入下面这行代码：

AddType application/octet-stream .pdf

这行的意思很直白：告诉Apache，所有扩展名是.pdf的文件，都用application/octet-stream这个MIME类型来处理。浏览器碰到这个类型，就会把它当作二进制数据流，直接弹出下载对话框，而不是尝试用内置PDF阅读器打开。

需要注意几个细节：

• 确保Apache启用了.htaccess支持，这通常需要在主配置文件中设置AllowOverride All。
• 修改完.htaccess后，最好重启一下Apache服务，不然改动可能不生效。

方法二：使用PHP Header设置

如果不想全局控制，或者需要更灵活地设置下载文件名，那就在PHP代码里通过HTTP头来引导浏览器下载。这是最常用的方式，也最容易控制细节。

下面是一段可以直接用的示例代码：

output(); // 从dompdf获取pdf二进制流

header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="' . basename($fileName) . '"');
header('Content-Length: ' . strlen($pdfData)); // 重要：设置Content-Length

echo $pdfData;
exit;
?>

拆解一下每行的作用：

• Content-Type: application/pdf：告诉浏览器这是一个PDF文件，不过配合后面的attachment，浏览器会忽略直接打开，直接下载。
• Content-Disposition: attachment; filename="..."：关键就是attachment，它强制浏览器把内容当作附件处理，也就是下载。文件名用basename()处理一下，防止有人搞路径注入的小动作。
• Content-Length: ...：虽然可以不写，但强烈建议加上。不写的话，有些浏览器在下载大文件时可能计算错误，导致文件损坏。
• 最后输出二进制内容，然后exit，防止脚本后面还有多余的HTML输出。

实际使用时容易翻车的地方：

• 文件损坏或打不开：多半是Content-Length算错了，或者$pdfData本身就不是有效的PDF数据。检查一下数据来源，确保输出前没有任何错误。
• "headers already sent"错误：在调用header()之前，绝对不要有任何输出。一个空格、一个换行、一个BOM头都会导致这个错误。检查PHP文件末尾的闭合标签?>后面是不是有多余的空行，试着去掉它。
• 文件名乱码：如果文件名包含中文或者其他非ASCII字符，可以先用urlencode()编码，或者用mb_convert_encoding()转成合适的编码。

总结一下

两种方法各有适用的场景：如果整个站点的PDF都想强制下载，改.htaccess最省事；如果只需要特定文件或者下载名需要动态控制，用PHP header更灵活。实现起来都不复杂，但务必注意上面提到的几个坑，尤其是去掉输出前的多余空格，以及正确设置文件大小。

实际开发中，这两招足够解决90%的PDF下载需求了。如果遇到其他奇怪的问题，多半是环境配置或者数据本身的问题，顺着排查思路一步步检查就好。