PHP使用<a>标签download属性下载CSV被存为TXT如何解决

CSV文件下载后被自动改为.txt后缀，本质是两个问题叠加导致：

• <a>标签的download属性未显式指定文件名，浏览器会根据服务器返回的Content-Type响应头自动推断文件后缀
• 当前Web服务器未给.csv后缀配置正确的text/csv MIME类型，默认将CSV文件识别为普通纯文本（text/plain），触发浏览器自动追加.txt后缀
  额外提示：现有代码将<button>嵌套在<a>标签内属于不符合HTML规范的写法，可能引发点击事件异常，直接给<a>标签添加按钮样式即可。

按实现成本从低到高选择即可：

方案1：显式指定download属性文件名（前端快速修复） #

给download属性传入完整的目标文件名，强制现代浏览器优先使用指定的文件名、后缀保存，无需修改服务端配置，修改后的前端代码如下：

<a href="log_files/log_files/abc.csv" download="abc.csv" class="btn btn-success">Download</a>

方案2：修正Web服务器MIME配置（静态文件场景根治） #

如果方案1在部分老旧浏览器下不生效，需要修正服务器对CSV文件的类型识别规则：

• Apache环境：在站点根目录的.htaccess文件或Apache主配置的MIME配置段添加以下规则：

AddType text/csv .csv

• Nginx环境：在配置目录下的mime.types文件中补充CSV类型映射，重载Nginx配置后生效：

types {
    text/csv csv;
}

方案3：PHP脚本中转下载（无服务端配置权限时最稳妥） #

如果没有修改Web服务器配置的权限，可以通过PHP脚本手动输出下载响应头，完全绕开静态资源的MIME识别逻辑，彻底避免后缀错乱问题。
首先在站点根目录新建download.php，代码如下：

<?php
// 限定CSV文件存储根目录，防范路径遍历攻击
$baseDir = __DIR__ . '/log_files/log_files/';
$fileName = basename($_GET['file'] ?? '');
$filePath = $baseDir . $fileName;

// 合法性校验
if (!is_file($filePath) || strtolower(pathinfo($filePath, PATHINFO_EXTENSION)) !== 'csv') {
    http_response_code(404);
    exit('Invalid file');
}

// 强制输出CSV下载响应头
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="' . $fileName . '"');
header('Content-Length: ' . filesize($filePath));
header('Pragma: no-cache');

// 输出文件内容
readfile($filePath);
exit;
?>

前端下载链接修改为指向该中转脚本即可：

<a href="download.php?file=abc.csv" class="btn btn-success">Download</a>

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