PHP输出Excel文件时如何避免编码自动转为UTF-8-BOM？

核心原因 #

PHP输出内容时，可能因输出缓冲区残留UTF-8 BOM、服务器自动压缩或错误的编码头设置，导致二进制Excel文件被篡改。Excel（尤其是.xls格式）属于二进制文件，不需要文本编码标识，直接输出原始内容即可。

解决方案 #

1. 清空输出缓冲区并禁用自动压缩 #

输出文件前，确保没有多余内容（包括BOM、空格、换行）被输出，同时关闭服务器自动压缩：

// 逐层清空所有输出缓冲区
while (ob_get_level()) {
    ob_end_clean();
}
// 禁用GZIP压缩，避免服务器修改文件内容
ini_set('zlib.output_compression', 'Off');

2. 发送正确的HTTP头信息 #

Excel是二进制文件，无需指定charset参数，发送适配的下载头即可：

$file_name = '导出数据.xls';
header('Content-Type: application/vnd.ms-excel');
header('Content-Disposition: attachment; filename="' . rawurlencode($file_name) . '"');
header('Cache-Control: max-age=0');
// 禁止PHP自动添加编码头
ini_set('default_charset', '');

3. 输出已保存的Excel文件（readfile方式） #

执行完缓冲区清理和头设置后，直接用readfile输出原始文件，输出后立即终止脚本：

$file_path = '/path/to/your/saved/file.xls';
readfile($file_path);
exit;

4. PHPExcel Writer直接输出到流的正确方式 #

使用save('php://output')前，必须完成缓冲区清理和头设置，同时确保Writer格式匹配：

// 创建对应格式的Writer（Excel5对应xls格式）
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel5');
// 清空缓冲区
while (ob_get_level()) {
    ob_end_clean();
}
// 设置下载头
header('Content-Type: application/vnd.ms-excel');
header('Content-Disposition: attachment; filename="导出数据.xls"');
header('Cache-Control: max-age=0');
// 输出到流
$objWriter->save('php://output');
exit;

5. 检查PHP脚本文件编码 #

确保你的PHP脚本本身是UTF-8无BOM编码（用Notepad++可查看并修改），脚本文件自带的BOM会被输出到文件开头，导致Excel解析错误。

关键提醒 #

.xls/.xlsx是二进制文件，不是文本文件，不要在头信息中设置charset，错误的编码标识会让Excel以文本模式解析二进制内容，引发乱码。

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