使用PHPExcel无法下载Excel文件的问题求助

问题描述 #

使用PHPExcel尝试导出.xlsx格式文件，初始化代码如下：

$objPHPExcel = new PHPExcel();

向Excel对象添加数据后，调用导出代码：

header('Content-type: application/vnd.ms-excel');
header('Content-Disposition: attachment; filename=$exportFileName');
$objWriter->save('php://output');
die();

执行后文件未触发下载，控制台出现乱码字符。

解决步骤 #

• 修正MIME类型
  .xlsx格式对应的正确MIME类型是application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，原代码中使用的application/vnd.ms-excel是针对旧版.xls文件的，会导致浏览器无法正确识别文件类型，直接输出二进制内容。

• 解析文件名变量
  PHP中单引号包裹的字符串不会解析变量，原代码里的filename=$exportFileName会被当作字面字符串，需改为双引号包裹或字符串拼接：

  // 方式1：双引号解析变量
  header("Content-Disposition: attachment; filename=$exportFileName");
  // 方式2：字符串拼接
  header('Content-Disposition: attachment; filename=' . $exportFileName);
  

• 清空输出缓冲区
  如果页面在执行导出代码前有任何隐性输出（比如空格、HTML注释、PHP错误信息），会导致HTTP头无法正确发送，进而出现乱码。在输出头信息前添加缓冲区清理代码：

  ob_clean();
  flush();
  

• 确认Writer对象类型正确
  导出.xlsx必须使用Excel2007类型的Writer，确保初始化代码正确：

  $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
  

修正后的完整代码示例 #

// 清空缓冲区，避免之前的输出干扰
ob_clean();
flush();

// 设置正确的响应头
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header("Content-Disposition: attachment; filename=$exportFileName");
header('Cache-Control: max-age=0'); // 禁用缓存

// 初始化对应格式的Writer
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
$objWriter->save('php://output');
exit; // 终止脚本执行

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