header已发送意味着php脚本在输出任何内容（包括空白字符、bom或之前的echo）后调用了header()函数，导致无法修改http响应头。解决的核心做法是立即停止脚本执行并清除缓冲区，或者在调用header之前确保没有任何输出。具体可以通过ob_start()开启输出缓冲，或在检测到错误时使用ob_clean()清理已发送的缓冲数据，从而让header()重新生效。
如何检测并阻止Header提前发送
要防止Header已发送的错误，必须在代码逻辑中明确检查输出状态。最直接的方法是在调用header()之前使用headers_sent()函数进行检测。如果该函数返回true，说明头部信息已经发送给浏览器，此时继续尝试修改头部将触发警告。因此，正确的做法是将文件下载的逻辑包裹在一个条件判断中，只有当头部未发送时才执行下载操作，否则抛出异常或记录日志，避免程序进入不可控状态。
<?php
// 模拟可能产生输出的前置代码
$debug = true;
if ($debug) {
// 这里如果有任何输出，都会导致后续header失败
// echo "Debug info";
}
// 检查头部是否已发送
if (headers_sent($file, $line)) {
die("Error: Headers already sent in $file on line $line");
}
// 设置下载头
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="example.txt"');
header('Content-Length: ' . filesize('example.txt'));
readfile('example.txt');
?>
上述代码展示了标准的防御性编程模式。首先通过headers_sent()获取发生错误的文件和行号，便于调试。随后才进行header设置。这种写法确保了只有在绝对安全的情况下才会执行下载逻辑。对于大型项目，建议将此类检查封装在基类或中间件中，统一处理所有可能的输出冲突。
立即学习“PHP免费学习笔记（深入）”；
利用输出缓冲解决已发送问题
当代码结构复杂，难以确定确切的前置输出位置时，使用输出控制函数（Output Control）是更彻底的解决方案。通过在脚本最开头调用ob_start()，PHP会将所有输出暂存在内存缓冲区中，而不是直接发送到浏览器。这样，即使中间有意外输出，只要在执行header()之前调用ob_clean()或ob_end_flush()，就可以清空或刷新缓冲区，从而保证header()能够成功执行。这种方法特别适用于包含大量HTML模板或第三方库的代码场景。
<?php
// 开启输出缓冲
ob_start();
// 模拟一些不可避免的早期输出
include 'header_template.php';
echo "Some debug text";
// 在设置下载头前，清理缓冲区
ob_clean();
// 现在可以安全地设置header
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="document.pdf"');
readfile('document.pdf');
// 结束缓冲并关闭
ob_end_flush();
?>
在这个方案中，ob_clean()起到了关键作用。它丢弃了缓冲区中现有的所有输出，使得后续的header()调用不会受到之前内容的干扰。需要注意的是，ob_start()必须放在脚本的最顶端，且不能有任何空白字符或BOM标记。此外，如果使用了session_start()，它也必须放在ob_start()之后，因为session也会涉及头部信息的写入。通过这种方式，开发者可以构建一个更加健壮的下载功能，避免因细微的输出错误导致整个流程失败。
基于Content-Disposition参数强制下载的具体行为
在解决了Header发送的技术障碍后，需要关注的是如何通过Content-Disposition参数精确控制浏览器的下载行为。该参数的值决定了文件是以附件形式强制下载，还是以内联形式在浏览器中预览。当设置为attachment时，浏览器会弹出保存对话框；当设置为inline时，浏览器会尝试直接显示文件内容（如图片、PDF等）。这一选择直接影响用户体验，特别是在处理非文本文件时。
在实际开发中，经常需要根据文件类型动态调整Content-Disposition的值。例如，对于图片文件，可能希望用户直接在页面查看，而对于文档文件，则希望强制下载。以下代码展示了如何根据文件扩展名动态设置该参数：
<?php
$file = 'image.jpg';
$ext = pathinfo($file, PATHINFO_EXTENSION);
// 定义哪些类型应该内联显示
$inline_types = ['jpg', 'jpeg', 'png', 'gif', 'pdf'];
if (in_array(strtolower($ext), $inline_types)) {
$disposition = 'inline';
} else {
$disposition = 'attachment';
}
header("Content-Disposition: $disposition; filename=".$file"");
readfile($file);
?>
这段代码通过检查文件扩展名来决定下载策略。如果扩展名在$inline_types数组中，则使用inline，否则使用attachment。这种灵活性使得同一个下载接口可以服务于多种类型的资源，提升了代码的复用性和用户体验。同时，这也提醒开发者，在处理Header时，不仅要考虑技术上的可行性，还要结合业务需求进行合理的参数配置。
