如何在Drupal中实现CSV报告一键下载功能？

我懂你的痛点——原来的方法只是把CSV内容打印在页面上，用户还要手动右键另存为，确实不够便捷。咱们直接修改submit处理函数，通过设置HTTP响应头来触发浏览器自动下载，一步到位！

针对 Drupal 7 的解决方案 #

先把你的表单submit处理逻辑换成下面的代码：

$page['submit'] = array(
  '#type' => 'submit',
  '#value' => 'Download Report',
  '#submit' => array('test_csv_download_submit'), // 替换成新的处理函数
);

function test_csv_download_submit($form, &$form_state) {
  // 第一步：准备你的报告CSV数据（这里用示例数据，替换成你实际的内容）
  $csv_content = "ID,Name,Department\n";
  $csv_content .= "1,Alice,Engineering\n";
  $csv_content .= "2,Bob,Marketing\n";

  // 第二步：设置HTTP响应头，告诉浏览器这是要下载的文件
  header('Content-Type: text/csv; charset=utf-8');
  // 指定下载的文件名，你可以根据需求动态生成（比如加日期）
  header('Content-Disposition: attachment; filename="department_report.csv"');

  // 第三步：输出CSV内容
  echo $csv_content;

  // 第四步：终止Drupal的页面渲染流程，避免输出多余的HTML内容
  drupal_exit();
}

关键说明： #

• Content-Disposition: attachment 是核心：它告诉浏览器把响应内容当作下载文件，而不是在页面中展示
• 一定要调用 drupal_exit()：如果不终止流程，Drupal会继续渲染页面的其他部分，导致CSV文件里混入多余的HTML代码
• 文件名可以动态调整：比如改成 "report_" . date('Y-m-d') . ".csv"，让用户每次下载的文件名带日期，更清晰

如果是 Drupal 8/9/10（面向对象写法） #

如果你的项目是新版本Drupal，写法会更规范，用响应对象来处理：

// 假设这是你的表单类中的submitForm方法
public function submitForm(array &$form, FormStateInterface $form_state) {
  // 准备CSV数据
  $csv_content = "ID,Name,Department\n";
  $csv_content .= "1,Alice,Engineering\n";
  $csv_content .= "2,Bob,Marketing\n";

  // 创建CSV响应对象
  $response = new \Symfony\Component\HttpFoundation\Response($csv_content);
  $response->headers->set('Content-Type', 'text/csv; charset=utf-8');
  $response->headers->set('Content-Disposition', 'attachment; filename="department_report.csv"');

  // 设置响应，终止表单流程
  $form_state->setResponse($response);
}

这样修改后，用户点击「Download Report」按钮就会直接弹出下载对话框，完全不用手动另存为，体验顺畅多了！

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