PHP实现PDF文件下载方法

在网站开发中，经常遇到需要让用户下载PDF文件（例如产品手册或后台生成的报告）的场景。然而，浏览器默认行为往往是在新标签页中直接打开PDF，导致用户可能关闭页面，未能完成下载。实际上，强制浏览器下载PDF文件并不复杂。以下介绍两种最常用的实现方法，并指出容易忽略的注意事项。

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

当使用Apache服务器，且希望站点内所有PDF文件都强制下载时，直接在站点根目录的.htaccess文件中添加一行配置即可。无需修改PHP代码，一劳永逸。

在.htaccess文件中（若不存在则新建），加入以下代码：

AddType application/octet-stream .pdf

该配置明确告知Apache：对所有扩展名为.pdf的文件，使用application/octet-stream作为MIME类型。浏览器遇到此类型时，会将其视为二进制数据流，从而弹出下载对话框，而非尝试在内置阅读器中打开。

需要注意以下细节：

• 确保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下载需求。若遇其他异常情况，通常与环境配置或数据本身有关，可按排查思路逐步检查。