PHP导出Excel报错：文件格式与扩展名不匹配，求即时解决

问题描述 #

我执行以下PHP代码生成.xls文件：

<?php 
header("Content-type: application/vnd.ms-excel"); 
header("Content-Disposition: attachment; filename=test.xls"); 
header("Pragma: no-cache"); 
header("Expires: 0"); 
$flag = false; 
foreach($data as $row) { 
    if(!$flag) { 
        echo implode("\t", array_keys($row)) . "\n"; 
        $flag = true; 
    } 
    array_walk($row, __NAMESPACE__ . '\cleanData'); 
    echo implode("\t", array_values($row)) . "\n"; 
} 
exit; 

下载后打开时出现错误提示：

您尝试打开的Facemappsoft.xls文件格式与扩展名不匹配

请问谁能帮我立即解决这个问题？

解决方案 #

别着急，这个问题太常见了——你当前的代码其实生成的是制表符分隔的纯文本文件，但硬给它套了.xls的扩展名，Excel一眼就看穿了格式不对，所以弹出了警告。下面给你几个快速落地的解决办法：

方法1：改用匹配的扩展名（最简单快速） #

既然生成的是制表符分隔的文本，那就把文件名改成test.tsv（制表符分隔文件的标准扩展名），同时更新响应头里的文件名：

header("Content-Disposition: attachment; filename=test.tsv");

这样Excel打开时会自动识别文件格式，再也不会弹出那个烦人的警告，操作成本几乎为零。

方法2：生成真正的Excel二进制文件（最规范） #

如果业务要求必须用.xls扩展名，那得生成符合标准的Excel二进制文件，而不是纯文本。推荐用PhpSpreadsheet（原PHPExcel）这个成熟的PHP库，示例代码如下：

// 先通过Composer安装PhpSpreadsheet：composer require phpoffice/phpspreadsheet
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xls;

// 初始化表格
$spreadsheet = new Spreadsheet();
$activeSheet = $spreadsheet->getActiveSheet();

// 写入表头
$headers = array_keys($data[0]);
$column = 'A';
foreach ($headers as $headerText) {
    $activeSheet->setCellValue($column . '1', $headerText);
    $column++;
}

// 写入数据行
$rowNumber = 2;
foreach ($data as $rowData) {
    $column = 'A';
    foreach ($rowData as $cellValue) {
        $activeSheet->setCellValue($column . $rowNumber, $cellValue);
        $column++;
    }
    $rowNumber++;
}

// 输出文件
$writer = new Xls($spreadsheet);
header('Content-Type: application/vnd.ms-excel');
header('Content-Disposition: attachment;filename="test.xls"');
header('Cache-Control: max-age=0');
// 直接输出到浏览器
$writer->save('php://output');
exit;

这种方法生成的是标准的.xls文件，完全符合Excel的格式要求，不会有任何兼容性警告。

方法3：强行绕过警告（不推荐） #

你也可以尝试修改响应头，比如把Content-Type改成application/octet-stream，或者添加X-Content-Type-Options: nosniff，但这只是让Excel“闭嘴”，本质上文件还是纯文本格式，后续可能会出现数据显示异常、无法编辑等问题，所以不建议这么做。

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