PHP生成临时CSV文件无法通过HTML链接下载的问题求助

问题根源 #

1. 系统临时目录（本地的/opt/lampp/temp、生产环境的/tmp）不在Web服务器的文档根目录范围内，直接用绝对路径作为URL时，浏览器会去网站根目录下查找对应路径，自然返回404。
2. 生产环境的/tmp是系统级临时目录，FTP用户没有访问权限，且系统会自动清理临时文件，所以你找不到生成的.csv文件。

解决方案 #

方案1：将文件移至Web可访问目录

这是最直接的方式，把处理后的CSV文件放到Web服务器能访问的目录下：

• 第一步：在你的项目根目录下创建一个专门的下载目录，比如downloads，设置目录权限为755（确保Web服务器有读写权限）。
• 第二步：修改PHP代码，把处理后的CSV文件从临时目录复制/移动到这个新目录：

  // 假设处理后的临时CSV文件路径为 $tmp_csv_path
  // 定义Web可访问的下载目录（项目根目录下的downloads）
  $download_dir = __DIR__ . '/downloads/';
  // 生成最终文件名（原文件名加.csv后缀）
  $final_filename = basename($_FILES['file_post']['name']) . '.csv';
  $final_filepath = $download_dir . $final_filename;
  
  // 将临时文件复制到目标目录
  if (copy($tmp_csv_path, $final_filepath)) {
      // 生成相对路径作为下载链接
      $download_url = 'downloads/' . $final_filename;
  }
  

• 第三步：输出下载链接时使用这个相对路径：

  <a href="<?php echo $download_url; ?>">Download csv file</a>
  

  此时本地链接会是localhost/downloads/xxx.csv，生产环境是mywebsite.fr/downloads/xxx.csv，能正常访问。

方案2：直接通过PHP输出文件内容（无需存储文件）

如果不想在服务器上保留下载文件，可以直接通过PHP脚本输出CSV内容，触发浏览器下载：

• 创建一个专门的下载脚本（比如download_csv.php），代码如下：

  <?php
  // 这里假设你已经处理好CSV内容，存储在$csv_content变量中
  $original_filename = basename($_FILES['file_post']['name']);
  
  // 设置响应头，告诉浏览器这是CSV文件并触发下载
  header('Content-Type: text/csv');
  header('Content-Disposition: attachment; filename="' . $original_filename . '.csv"');
  header('Pragma: no-cache');
  header('Expires: 0');
  
  // 输出CSV内容
  echo $csv_content;
  exit;
  ?>
  

• 然后把下载链接指向这个脚本：

  <a href="download_csv.php">Download csv file</a>
  

  这种方式不需要存储文件，避免了文件堆积和权限问题，安全性更高。

额外注意事项

• 生产环境中，务必不要依赖系统临时目录存储需要提供下载的文件，系统会定期清理这些文件，且FTP用户无法访问。
• 定期清理downloads目录下的旧文件，避免占用过多服务器空间。

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