在Web开发中，经常需要提供文件下载功能。然而，有时会遇到一个令人困扰的问题：当用户在移动浏览器上下载文件时，文件名会被自动添加“.html”后缀，例如，原本应该是 card.vcf 的文件，下载后变成了 card.vcf.html。这通常是由于服务器响应头设置不当引起的，导致浏览器误判文件类型。下面将详细介绍如何通过正确的服务器响应头设置来解决这个问题。
正确设置HTTP响应头
关键在于正确设置 Content-Type 和 Content-Disposition 两个HTTP响应头。此外，为了避免缓存问题，建议添加一些缓存控制相关的头部。
以下是一个示例，展示了如何设置这些头部，以确保文件能够正确下载，并且避免被添加“.html”后缀：
立即学习“前端免费学习笔记（深入）”；
代码解释：
- Content-Description: Download vCard: 描述文件用途，可以自定义。
- Content-Type: text/vcard: 指定文件的 MIME 类型。对于 vCard 文件，使用 text/vcard。 根据你下载的文件类型，替换为相应的 MIME 类型。 常见的MIME类型包括：
- Content-Disposition: attachment; filename="' . $your_filename_here . '": 指定浏览器以下载方式处理响应，并设置下载的文件名。 文件名需要用双引号包裹，以避免特殊字符导致的问题。
- Content-Transfer-Encoding: binary: 指定数据传输的编码方式，对于二进制文件，使用 binary。
- Expires: 0: 指示浏览器不要缓存此响应。
- Cache-Control: must-revalidate, post-check=0, pre-check=0: 更详细的缓存控制，确保浏览器在每次请求时都重新验证。
- Pragma: public: 允许公共缓存服务器缓存此响应。
- ob_clean(); flush();: 清除并刷新输出缓冲区，确保在发送文件内容之前没有其他输出。
- echo $vcard_serialized;: 输出要下载的文件内容。
- exit;: 结束脚本执行，防止后续代码干扰文件下载。
注意事项：
- MIME类型： 确保 Content-Type 设置为正确的文件 MIME 类型。错误的 MIME 类型会导致浏览器无法正确识别文件，从而可能添加“.html”后缀。
- 文件名编码： 如果文件名包含特殊字符（如中文），可能需要进行URL编码，以确保浏览器能够正确解析。可以使用 urlencode() 函数进行编码。
- 缓冲区处理： 在输出文件内容之前，务必清除并刷新输出缓冲区，以避免出现意外的输出。
- 脚本结束： 在文件内容输出完毕后，使用 exit; 结束脚本执行，防止后续代码干扰文件下载过程。
- 服务器配置： 有些服务器配置（如Apache的.htaccess文件）可能会覆盖你设置的HTTP响应头。如果上述方法无效，请检查服务器配置是否影响了响应头。
总结
通过正确设置HTTP响应头，特别是 Content-Type 和 Content-Disposition，并添加适当的缓存控制，可以有效地解决移动浏览器下载文件时自动添加“.html”后缀的问题。 确保你的代码遵循上述建议，并且注意检查服务器配置，以获得最佳的文件下载体验。
