php怎么写兼容header输出_php避免header已发送错误兼容操作【操作】-php教程

根本原因是输出缓冲未被正确控制；只要header()前有非缓冲输出（空格、BOM、echo等）即触发错误，而本地与线上环境因output_buffering和implicit_flush配置及UTF-8 BOM差异导致表现不一致。

PHP 中 header() 报 “headers already sent” 错误，根本原因不是 PHP 版本或写法过时，而是输出缓冲未被正确控制——只要在 header() 前有任何非缓冲输出（空格、BOM、echo、print、甚至文件末尾换行），就会触发该错误。

为什么 header 已发送错误在不同环境表现不一致？

本地开发常“不报错”，上线就崩，主要因为：

• 服务器开启 output_buffering = On（默认 4096 字节）时，PHP 会暂存输出，掩盖早期小量输出问题
• php.ini 中 implicit_flush = Off 会让缓冲行为更隐蔽
• UTF-8 BOM（尤其是 Windows 编辑器保存的 .php 文件）会在 <?php 前悄悄输出 \xEF\xBB\xBF，肉眼不可见但直接破坏 header
• include/require 的文件末尾有空行或空格，也会提前触发输出

最稳妥的兼容性写法：output\_buffering + header\_sent 检查

不依赖环境配置，主动管理缓冲层：

// 开启输出缓冲（放在所有可能输出之前，通常在入口文件第一行）
ob_start();

// 后续任意位置可安全调用 header()
if (!headers_sent()) {
    header('Location: /login.php');
    exit;
} else {
    // 已发送则降级处理（如 JS 跳转或显示提示）
    echo '';
    exit;
}

• ob_start() 必须在任何输出前调用，包括空白字符；建议放在 index.php 顶部第一行
• headers_sent() 是唯一可靠判断依据，不要用 ob_get_level() 或 ob_get_contents() 替代
• 若已启用 output_buffering，ob_start() 仍可嵌套，但需配对 ob_end_flush() 或 ob_end_clean()

排查和修复常见隐性输出源

这类问题往往藏在你看不见的地方：