使用 php 强制下载 excel 文件（.xlsx）的核心做法是设置 http 响应头并输出二进制内容。你需要调用 header() 函数设置 content-type 为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，设置 content-disposition 为 attachment 并指定文件名，然后读取文件内容并通过 readfile() 或 fopen() 输出到标准输出流。这样做会覆盖浏览器默认的预览行为，强制触发浏览器的“另存为”对话框。
如何正确设置 HTTP 响应头以触发下载
要确保浏览器不尝试在标签页内打开文件而是下载它，必须严格遵循特定的头部字段格式。关键在于 Content-Disposition 的值必须包含 attachment 关键字，且文件名若包含非 ASCII 字符（如中文），需要使用 RFC 5987 标准的编码方式，即 filename*=UTF-8''... 的形式。如果只使用简单的 filename=xxx.xlsx，在某些浏览器中可能导致乱码或无法识别扩展名。此外，必须在输出任何 HTML 内容之前执行这些 header() 调用，否则会导致 “Headers already sent” 错误。
<?php
// 假设文件路径
$file_path = '/path/to/your/report.xlsx';
$filename = 'report.xlsx';
// 检查文件是否存在
if (!file_exists($file_path)) {
http_response_code(404);
die('File not found');
}
// 获取文件大小
$file_size = filesize($file_path);
// 设置 MIME 类型
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
// 设置 Content-Disposition，支持中文文件名
header('Content-Disposition: attachment; filename="' . $filename . '"; filename*=UTF-8\'\''. rawurlencode($filename) . '\'' );
// 设置内容长度
header('Content-Length: ' . $file_size);
// 清除缓冲区并关闭输出缓冲
if (ob_get_level()) ob_end_clean();
// 输出文件内容
readfile($file_path);
exit;
?>
上述代码首先验证文件存在性，防止无效请求。接着通过 header() 依次声明类型、处置方式和长度。最后 readfile() 将文件指针内容直接推送到输出缓冲区。注意 exit 的使用是为了防止后续脚本继续执行产生额外输出，破坏二进制流的完整性。
立即学习“PHP免费学习笔记（深入）”；
如何处理大文件或避免内存溢出
当 Excel 文件较大时，直接使用 readfile() 可能会因为一次性加载整个文件到内存而导致 PHP 进程崩溃或超时。更稳健的做法是使用 fopen() 和 fread() 配合循环分块读取。这种方式允许服务器以较小的数据块（例如 8KB 或 64KB）逐步发送数据给客户端，从而保持内存占用恒定。同时，需要设置 Connection: keep-alive 和 Pragma: public 等头部来优化网络传输效率，特别是在处理超过几十 MB 的文件时。
<?php
$file_path = '/path/to/large_report.xlsx';
$filename = 'large_report.xlsx';
if (!file_exists($file_path)) {
http_response_code(404);
die('File not found');
}
// 设置头部
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment; filename="' . $filename . '"; filename*=UTF-8\'\''. rawurlencode($filename) . '\'' );
header('Content-Length: ' . filesize($file_path));
header('Cache-Control: no-cache');
header('Pragma: public');
// 分块读取
$chunk_size = 8192; // 8KB
$handle = fopen($file_path, 'rb');
if ($handle === false) {
die('Unable to open file');
}
while (!feof($handle)) {
echo fread($handle, $chunk_size);
flush(); // 刷新输出缓冲区，确保数据立即发送
}
fclose($handle);
exit;
?>
此方案通过 flush() 强制将已读取的数据块发送给浏览器，避免等待脚本结束才发送。这对于用户体验至关重要，尤其是当用户点击下载后能立即看到进度条开始移动。相比 readfile()，这种手动循环虽然代码稍多，但极大地提升了稳定性和对大文件的兼容性。
基于程序中某个输入、条件或结果的具体问题：中文文件名乱码怎么办
如果在实际运行中发现下载的文件名显示为乱码，通常是因为 Content-Disposition 头部中的文件名未正确编码。PHP 的 rawurlencode() 函数可以将中文字符转换为 URL 安全的百分号编码格式，这是解决跨浏览器兼容性问题的关键。仅使用双引号包裹中文文件名在现代浏览器中往往不够可靠，必须同时提供 filename*=UTF-8''... 这一扩展参数。浏览器会优先解析 filename*，如果解析失败则回退到 filename。因此，确保 filename* 部分始终存在且编码正确，是解决中文文件名问题的唯一可靠途径。
