如何用PHP导出Excel文件并消除警告（.xlsx无法正常使用）

问题背景 #

导出.xls格式文件时，Excel弹出格式不匹配的警告；尝试改用.xlsx格式但无法正常工作，当前使用的PHP代码如下：

header("Content-Type: application/xls");
header("Content-Type: application/octet-stream"); 
header('Content-Encoding: UTF-8');
header('Content-Type: application/vnd.ms-excel; charset=UTF-8');
$data = "Some utf-8 characters ąćżźćł";
header("Content-Transfer-Encoding: binary"); 
header('Expires: '.gmdate('D, d M Y H:i:s').' GMT'); 
header('Content-Disposition: attachment; filename = "Export '.date("Y-m-d").'.tsv"'); 
header("Content-Disposition: attachment; filename=municipaliteties_list.xls");
header("Pragma: no-cache");
header("Expires: 0");

问题根源 #

1. 重复HTTP头冲突：多次重复设置Content-Type和Content-Disposition，导致浏览器和Excel识别文件类型/名称混乱；
2. 文件格式不匹配：输出的是纯文本内容，却伪装成.xls格式，Excel检测到内容与后缀不符时会弹出警告；
3. UTF-8编码未做适配：直接输出UTF-8字符，旧版Excel无法自动识别编码，易出现乱码或额外警告。

修复方案 #

方案一：调整头信息与编码，减少警告（快速修复）

清理重复头，添加UTF-8 BOM让Excel正确识别编码，同时统一文件格式标识：

// 设置正确的响应头，避免重复
header('Content-Type: application/vnd.ms-excel; charset=UTF-8');
header('Content-Disposition: attachment; filename=municipaliteties_list.xls');
header('Expires: '.gmdate('D, d M Y H:i:s').' GMT');
header('Pragma: no-cache');
header('Expires: 0');

// 添加UTF-8 BOM，解决旧版Excel编码识别问题
echo "\xEF\xBB\xBF";

// 输出制表符分隔的表格数据（模拟Excel结构）
$data = "列名1\t列名2\t列名3\n";
$data .= "示例内容\tSome utf-8 characters ąćżźćł\t更多内容\n";
echo $data;

方案二：生成标准Excel文件，彻底消除警告（推荐）

上述方案只是减少警告，本质还是文本文件伪装成xls。要彻底解决，建议使用专业库生成标准Excel格式，比如PhpSpreadsheet（PHPExcel的官方替代库）：

1. 先通过Composer安装库：

composer require phpoffice/phpspreadsheet

2. 导出.xls的示例代码：

require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xls;

// 创建Excel对象
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();

// 填充数据
$sheet->setCellValue('A1', '列名1');
$sheet->setCellValue('B1', '列名2');
$sheet->setCellValue('B2', 'Some utf-8 characters ąćżźćł');

// 设置响应头并导出
header('Content-Type: application/vnd.ms-excel');
header('Content-Disposition: attachment; filename=municipaliteties_list.xls');

$writer = new Xls($spreadsheet);
$writer->save('php://output');

如果需要导出.xlsx格式，只需替换Writer类和Content-Type：

// 替换为Xlsx Writer
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

// 修改Content-Type
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');

$writer = new Xlsx($spreadsheet);
$writer->save('php://output');

你之前尝试.xlsx失败，是因为仅修改了文件名和头信息，但输出的还是纯文本内容，使用PhpSpreadsheet生成标准格式即可正常工作。

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