如何修复 PHP 中的“标头已发送”错误

Posted 2023-02-22

技术标签:

【中文标题】如何修复 PHP 中的“标头已发送”错误【英文标题】：How to fix "Headers already sent" error in PHP 【发布时间】：2022-01-03 18:21:23 【问题描述】：

在运行我的脚本时，我遇到了几个类似这样的错误：

警告：无法修改标头信息 - 标头已由 /some/file.php 中的（输出开始于 /some/file.php:12）发送strong>第 23 行

错误消息中提到的行包含header() 和setcookie() 调用。

这可能是什么原因？以及如何解决？

【问题讨论】：

阅读：***.com/questions/1912029/… 确保不输出任何文本（ob_start 和 ob_end_clean() 在这里可能很有用）。然后您可以设置一个等于ob_get_contents() 的cookie 或会话，然后使用ob_end_clean() 清除缓冲区。在我的 php 库中使用 safeRedirect 函数：github.com/heinkasner/PHP-Library/blob/master/extra.php ~~~~~~~~~~ 你的文件编码不应该是UTF-8，而是UTF-8 (Without BOM)~~~~~~~~~~~ 【参考方案1】：

在您发送 HTTP 标头（使用 setcookie 或 header）之前发送 anything 时会触发此错误消息。在 HTTP 标头之前输出内容的常见原因是：

意外的空格，通常在文件的开头或结尾，如下所示：

 <?php
// Note the space before "<?php"
?>

为避免这种情况，只需省略结尾的?> - 无论如何都不需要。

Byte order marks 在 php 文件的开头。使用十六进制编辑器检查您的 php 文件，以确定是否是这种情况。它们应该以字节3F 3C 开头。您可以安全地从文件开头删除 BOM EF BB BF。显式输出，例如调用echo、printf、readfile、passthru、<? 之前的代码等。如果设置了display_errors php.ini 属性，则php 输出警告。 php 不会因为程序员的错误而崩溃，而是默默地修复错误并发出警告。虽然您可以修改 display_errors 或 error_reporting 配置，但您应该解决问题。常见的原因是访问数组的未定义元素（例如 $_POST['input'] 而不使用 empty 或 isset 来测试是否设置了输入），或者使用未定义的常量而不是字符串文字（如 $_POST[input] ，请注意缺少的引号）。

打开output buffering 应该可以解决问题；调用ob_start 后的所有输出都缓存在内存中，直到您释放缓冲区，例如ob_end_flush。

但是，虽然输出缓冲可以避免这些问题，但您应该真正确定应用程序在 HTTP 标头之前输出 HTTP 正文的原因。这就像在告诉来电者他打错号码之前，先打个电话，讨论一下你的日子和天气。

【讨论】：

【参考方案2】：

你会的

printf ("Hi %s,</br />", $name);

在设置 cookie 之前，这是不允许的。您不能在标题之前发送任何输出，甚至是空行。

【讨论】：

【参考方案3】：

正是因为这一行：

printf ("Hi %s,</br />", $name);

在发送标头之前，您不应打印/回显任何内容。

【讨论】：

【参考方案4】：

发送标头前无输出！

必须调用发送/修改 HTTP 标头的函数在进行任何输出之前。 summary ⇊ 否则调用失败：

警告：无法修改标头信息 - 标头已发送（输出开始于 script:line）

一些修改HTTP头的函数有：

header / header_remove session_start / session_regenerate_id setcookie / setrawcookie

输出可以是：

无意：

<?php 之前或?> 之后的空格 UTF-8 Byte Order Mark 专门以前的错误消息或通知

故意的：

print、echo 和其他产生输出的函数 <html> 之前的原始 <?php 代码部分。

为什么会这样？

要了解为什么必须在输出之前发送标头，有必要看一个典型的HTTP 回复。 PHP 脚本主要生成 HTML 内容，同时也传递一个一组 HTTP/CGI 标头到网络服务器：

HTTP/1.1 200 OK
Powered-By: PHP/5.3.7
Vary: Accept-Encoding
Content-Type: text/html; charset=utf-8

<html><head><title>PHP page output page</title></head>
<body><h1>Content</h1> <p>Some more output follows...</p>
and <a href="/"> <img src=internal-icon-delayed> </a>

页面/输出总是跟随标题。 PHP 必须通过首先将标头发送到网络服务器。它只能这样做一次。双换行后再也不能修改了。

当 PHP 接收到第一个输出（print、echo、<html>）时，它将 flush 所有收集的标头。之后它可以发送所有输出它想要。但是，发送更多的 HTTP 标头是不可能的。

如何找出过早输出发生的位置？

header() 警告包含所有相关信息定位问题原因：

警告：无法修改标头信息 - 标头已由 （输出开始于 /www/usr2345/htdocs/auth.php:52）在 /www/usr2345/htdocs/index.php 第 100 行

这里的“第 100 行”指的是 header() 调用失败的脚本。

括号内的“输出开始于”注释更重要。它指定先前输出的来源。在这个例子中，它是auth.php 和线52。这就是你必须寻找过早输出的地方。

典型原因：

打印，回显

print 和 echo 语句的有意输出将终止发送 HTTP 标头的机会。必须重组应用程序流程以避免这种情况。使用functions 和模板方案。确保header() 调用发生在之前消息都写出来了。

产生输出的函数包括

print

echo

printf

vprintf

trigger_error

ob_flush

ob_end_flush

var_dump

print_r

readfile

passthru

flush

imagepng

imagejpeg

以及用户定义的函数。

原始 HTML 区域

.php 文件中未解析的 HTML 部分也是直接输出。必须注意将触发header() 调用的脚本条件在任何原始<html>块之前。

<!DOCTYPE html>
<?php
    // Too late for headers already.

使用模板方案将处理与输出逻辑分开。

`<?php` 之前的空格用于“script.php line 1”警告

如果警告是指输出内联1，那么它主要是在开头的<?php 标记前前导空格、文本或HTML。

 <?php
# There's a SINGLE space/newline before <? - Which already seals it.

附加的脚本或脚本部分也可能发生这种情况：

?>

<?php

PHP 实际上在关闭标签之后吃掉了一个 single 换行符。但它不会补偿移入此类间隙的多个换行符或制表符或空格。

UTF-8 物料清单

单独的换行符和空格可能是个问题。但也有“隐形” 可能导致这种情况的字符序列。最著名的是 UTF-8 BOM (Byte-Order-Mark) 大多数文本编辑器不显示。它是字节序列EF BB BF，对于 UTF-8 编码的文档是可选的和冗余的。然而，PHP 必须将其视为原始输出。它可能在输出中显示为字符 ï»¿（如果客户端将文档解释为 Latin-1）或类似的“垃圾”。

尤其是图形编辑器和基于 Java 的 IDE 在场。他们没有将其可视化（Unicode 标准要求）。然而，大多数程序员和控制台编辑器都会这样做：

很容易尽早发现问题。其他编辑可能会识别它出现在文件/设置菜单中（Windows 上的 Notepad++ 可以识别和 remedy the problem), 检查 BOM 存在的另一种选择是使用 hexeditor。在 *nix 系统上hexdump 通常可用，如果不是简化审核这些问题和其他问题的图形变体：

一个简单的解决方法是将文本编辑器设置为将文件保存为“UTF-8（无 BOM）” 或类似这样的命名法。新手通常会采取其他方式创建新文件，然后将以前的代码复制并粘贴回去。

更正实用程序

还有用于检查和重写文本文件的自动化工具（sed/awk 或 recode）。对于 PHP，特别是有 phptags tag tidier。它将关闭和打开标签重写为长格式和短格式，但也很容易修复前导和尾随空格、Unicode 和 UTF-x BOM 问题：

phptags  --whitespace  *.php

在整个包含或项目目录中使用是安全的。

`?>` 后面的空格

如果错误源在后面提到 closing ?> 然后这是一些空白或原始文本被写出的地方。 PHP 结束标记此时不会终止脚本执行。其后的任何文本/空格字符都将作为页面内容写出还是。

通常建议，特别是对于新手，尾随 ?> PHP 应省略关闭标签。这避开这些案例的一小部分。（通常include()d 脚本是罪魁祸首。）

提到的错误源为“第 0 行未知”

如果没有错误源，通常是 PHP 扩展或 php.ini 设置被具体化了。

gzip

ob_gzhandler

extension=

前面的错误消息

如果另一个 PHP 语句或表达式导致警告消息或注意被打印出来，也算过早输出。

在这种情况下，您需要避免错误，延迟语句执行，或使用例如抑制消息 isset() 或 @() - 当任何一个都不会妨碍以后的调试时。

没有错误信息

如果您根据php.ini 禁用了error_reporting 或display_errors，然后不会出现任何警告。但是忽略错误不会解决问题离开。过早输出后仍然无法发送标头。

所以当header("Location: ...") 重定向静默失败时，它非常建议探测警告。使用两个简单的命令重新启用它们在调用脚本之上：

error_reporting(E_ALL);
ini_set("display_errors", 1);

或者set_error_handler("var_dump");，如果一切都失败了。

说到重定向标头，您应该经常使用类似的成语这是最终代码路径：

exit(header("Location: /finished.html"));

最好是实用功能，打印用户消息在header() 失败的情况下。

输出缓冲作为一种解决方法

PHP output buffering 是缓解此问题的一种解决方法。它通常可靠地工作，但不应该替代适当的应用程序结构并将输出与控制分离逻辑。它的实际目的是尽量减少到网络服务器的分块传输。

output_buffering= 设置仍然可以提供帮助。配置在php.ini 或通过.htaccess 甚至.user.ini on 现代 FPM/FastCGI 设置。启用它将允许 PHP 缓冲输出，而不是立即将其传递给网络服务器。因此 PHP 可以聚合 HTTP 标头。

同样可以拨打ob_start(); 在调用脚本之上。然而，由于多种原因，这不太可靠：

即使<?php ob_start(); ?> 启动第一个脚本，空格或 BOM 之前可能会被洗牌，rendering it ineffective。

它可以隐藏 HTML 输出的空白。但是一旦应用程序逻辑尝试发送二进制内容（例如生成的图像），缓冲的无关输出成为问题。（需要ob_clean() 作为进一步的解决方法。）

缓冲区的大小是有限的，并且在保留默认值时很容易溢出。这也不是罕见的事情，difficult to track down 当它发生时。

因此，这两种方法都可能变得不可靠——尤其是在两者之间切换时开发设置和/或生产服务器。这就是为什么输出缓冲是被广泛认为只是一种拐杖/严格来说是一种解决方法。

另见basic usage example 在手册中，以及更多的利弊：

What is output buffering? Why use output buffering in PHP? Is using output buffering considered a bad practice? Use case for output buffering as the correct solution to "headers already sent"

但它在另一台服务器上工作！？

如果您之前没有收到标题警告，那么output buffering php.ini setting 已经改变。它可能在当前/新服务器上未配置。

检查`headers_sent()`

您可以随时使用headers_sent() 来探测是否仍然可以...发送标头。这对有条件地打印很有用信息或应用其他后备逻辑。

if (headers_sent()) 
    die("Redirect failed. Please click on this link: <a href=...>");

else
    exit(header("Location: /user.php"));

有用的后备解决方法是：

HTML `<meta>` 标签

如果您的应用程序在结构上难以修复，那么一个简单（但有点不专业）允许重定向的方法是注入 HTML <meta> 标签。可以通过以下方式实现重定向：

 <meta http-equiv="Location" content="http://example.com/">

或稍作延迟：

 <meta http-equiv="Refresh" content="2; url=../target.html">

当使用超过 <head> 部分时，这会导致 HTML 无效。大多数浏览器仍然接受它。

javascript 重定向

作为替代JavaScript redirect 可用于页面重定向：

 <script> location.replace("target.html"); </script>

虽然这通常比 <meta> 解决方法更符合 HTML，它会导致对支持 JavaScript 的客户端的依赖。

然而，当真正的 HTTP header() 通话失败。理想情况下，您总是将其与用户友好的消息结合起来，并且可点击的链接作为最后的手段。（例如http_redirect() PECL 扩展确实如此。）

为什么`setcookie()`和`session_start()`也会受到影响

setcookie() 和 session_start() 都需要发送一个 Set-Cookie: HTTP 标头。因此适用相同的条件，并且将生成类似的错误消息用于过早输出的情况。

（当然，它们还会受到浏览器中禁用的 cookie 的影响甚至代理问题。会话功能显然也依赖于免费磁盘空间和其他 php.ini 设置等）

更多链接

Google 提供了lengthy list of similar discussions。当然，many specific cases 也被 Stack Overflow 报道过。 WordPress 常见问题解答以通用方式解释了 How do I solve the Headers already sent warning problem?。 Adobe 社区：PHP development: why redirects don't work (headers already sent) Nucleus 常见问题解答：What does "page headers already sent" mean? 更详尽的解释之一是HTTP Headers and the PHP header() Function - A tutorial by NicholasSolutions（Internet 存档链接）。它详细介绍了 HTTP，并提供了一些重写脚本的指南。

【讨论】：

常规 notepad.exe 也很棘手。我通常使用不添加 BOM 的 NetBeans，即使文件是这样编码的。稍后在记事本中编辑文件会使事情变得混乱，尤其是将 IIS 作为网络服务器。似乎 apache 丢弃了（无意添加的）BOM。从 php 文件的末尾删除关闭 ?> 通常是一种很好的做法，它也有助于最大限度地减少这些错误。不需要的空格不会出现在文件的末尾，您仍然可以稍后将标头添加到响应中。如果您使用输出缓冲，它也很方便，并且不希望在包含的文件生成的部分末尾看到添加的不需要的空白。奇怪的事情，我把我的文件从 cPanel Linux Hosting 移到了 VPS。在它正常工作之前，但在这里它显示了这个错误。（我在标题之前有一些 html 代码）。为什么？ @PeterSMcIntyre UTF8 BOM 大概（修复）/没有启用输出缓冲（不要依赖它）。只是遗漏了一个细节，您可能需要添加。如果错误消息省略了该信息，$file = $line = null; headers_sent($file, $line); die("$file:$line"); 将准确告诉您发送标头的内容。不知道为什么，但有时似乎是这样。【参考方案5】：

一个简单的提示：脚本中的一个简单的空格（或不可见的特殊字符），就在第一个 <?php 标记之前，可能会导致这种情况！尤其是当您在团队中工作并且有人使用“弱”的 IDE 或使用奇怪的文本编辑器处理文件时。

我见过这些东西；）

【讨论】：

【参考方案6】：

我之前多次遇到过这个错误，我敢肯定所有 PHP 程序员之前至少遇到过一次。

可能的解决方案 1

此错误可能是由文件开头之前或文件结尾之后的空格引起的。这些空格不应该在这里。

例如）这里不应该有空格

   echo "your code here";

?>
THERE SHOULD BE NO BLANK SPACES HERE

检查与导致此错误的文件关联的所有文件。

注意： 有时像 gedit（一个默认的 linux 编辑器）这样的 EDITOR(IDE) 会在保存文件中添加一个空行。这不应该发生。如果您使用的是 Linux。您可以使用 VI 编辑器删除页面末尾的 ?> 之后的空格/行。

可能的解决方案 2： 如果这不是你的情况，那么使用ob_start 输出缓冲：

<?php
  ob_start();

  // code 

 ob_end_flush();
?>

这将打开输出缓冲，并在页面缓冲后创建标题。

【讨论】：

ob_start() 只是隐藏了问题；不要用它来解决这个特定的问题。 ob_start() 没有“隐藏”问题，它解决了问题。我上传文件到服务器时遇到了这样的问题，它甚至支持 PHP5.3 使用 PHP 5.6 或更高版本的服务器 @jack 是的，我同意你的看法。理想的方法是在开始php标签<?之前删除空格解决了我的问题。【参考方案7】：

而不是下面的行

//header("Location:".ADMIN_URL."/index.php");

写

echo("<script>location.href = '".ADMIN_URL."/index.php?msg=$msg';</script>");

或

?><script><?php echo("location.href = '".ADMIN_URL."/index.php?msg=$msg';");?></script><?php

它肯定会解决您的问题。我遇到了同样的问题，但我通过上面的方式写标题位置解决了。

【讨论】：

【参考方案8】：

另一个不好的做法可能会引发这个尚未说明的问题。

查看这段代码sn-p：

<?php
include('a_important_file.php'); //really really really bad practise
header("Location:A location");
?>

一切都还好，对吧？

如果“a_important_file.php”是这样的：

<?php
//some php code 
//another line of php code
//no line above is generating any output
?>

 ----------This is the end of the an_important_file-------------------

这行不通？为什么？因为已经生成了一个新行。

现在，虽然这不是一个常见的场景，但如果您使用的是 MVC 框架，该框架会在将内容移交给控制器之前加载大量文件，该怎么办？这种情况并不少见。做好准备。

来自PSR-2 2.2 :

所有 PHP 文件必须使用 Unix LF (linefeed) line ending。 所有 PHP 文件必须以 single blank line 结尾。 结束 ?> 标记必须是 omitted，来自包含 only php 的文件

相信我，遵循这些标准可以为您节省大量时间:)

【讨论】：

根据几个标准（例如 Zend），在任何情况下，您都不应该将结束 ?> 标记放在任何文件中我无法在 Windows 环境中重现它，因为它可以使用任何组合（添加结束标签、空格、按 Enter 键等）。似乎这个问题主要发生在 Linux 环境中。 @JuniorM 它应该是可重现的。你能分享一下你在 gist 或类似的东西上试验的代码吗？我在 Windows 7 上，安装了最新的 Wamp。我认为这个错误与行尾的隐藏字符有关。我的 Wordpress 的 shortcodes.php 是导致问题的原因。我在这个文件中添加了一个简单的函数，它开始触发这个“headers sent”错误。我已经将我的 shortcodes.php 与 wordpress' 进行了比较，除了 CR LF （典型的 Windows 行尾）之外，一切正常。我通过从具有LF（Linux 行尾）而不是CR LF 的Wordpress repo 下载原始文件来解决它，并且我还将我的函数移动到主题的functions.php。基于：bit.ly/1Gh6mzN @Sahib，请注意我仍然无法重现此答案中所述的内容。答案对于 Linux 环境来说完全没问题。我已经测试了?><?php之间的空白，删除和添加单个空白行，添加和省略结束标记?>。在 Windows+ Wamp 中，所有这些组合都可以正常工作。奇怪...【参考方案9】：

通常当我们在回显或打印后发送标题时会出现此错误。如果此错误出现在特定页面上，请确保该页面没有回显任何内容，然后再调用 start_session()。

不可预测的错误示例：

 <?php //a white-space before <?php also send for output and arise error
session_start();
session_regenerate_id();

//your page content

再举一个例子：

<?php
includes 'functions.php';
?> <!-- This new line will also arise error -->
<?php
session_start();
session_regenerate_id();

//your page content

结论：在调用session_start() 或header() 函数之前不要输出任何字符，即使是空格或换行符也不行

【讨论】：

【参考方案10】：

常见问题：

（复制自：source）

=====================

1)在header(.......);命令之前不应有任何输出（即echo..或HTML代码）。 p>

2) 删除<?php 之前和?> 标记之后的所有空白（或换行符）。

3) 黄金法则！ - 检查该 php 文件（以及，如果你 include 其他文件）是否有 UTF8 没有 BOM 编码（而不仅仅是 UTF-8）。这在很多情况下都是问题（因为 UTF8 编码文件在 php 文件的开头有一些特殊字符，您的文本编辑器没有显示）！！！！！！！！！！！！！！！

4) 在header(...); 之后必须使用exit;

5) 始终使用 301 或 302 引用：

header("location: http://example.com",  true,  301 );  exit;

6) 开启报错，发现错误。你的错误可能是某个功能不工作造成的。当您打开错误报告时，您应该始终首先修复最重要的错误。例如，它可能是“警告：date_default_timezone_get()：依赖系统的时区设置是不安全的”。 - 然后再往下看，您可能会看到“未发送标头”错误。修复最顶层（第一个）错误后，重新加载您的页面。如果仍然有错误，请再次修复最顶层的错误。

7) 如果以上都没有帮助，使用 JAVSCRIPT 重定向（但是，强烈不推荐的方法），可能是自定义情况下的最后机会...：

echo "<script type='text/javascript'>window.top.location='http://website.com/';</script>"; exit;

【讨论】：

为什么显式设置301 或302 很重要？如果设置了 php.ini 文件中的“output_buffering”，就可以有输出。我在我家的 Debian 系统上设置为 4096。我使用的服务器上的那个说它没有设置。【参考方案11】：

有时，当开发进程同时具有 WIN 工作站和 LINUX 系统（托管）并且在代码中您在相关行之前看不到任何输出时，可能是文件的格式和缺少 Unix LF（换行） 行结束。

为了快速解决这个问题，我们通常会做的是重命名文件并在 LINUX 系统上创建一个新文件而不是重命名的文件，然后将内容复制到该文件中。很多时候这解决了这个问题，因为在 WIN 中创建的一些文件一旦移动到主机就会导致这个问题。

对于我们通过 FTP 管理的网站来说，此修复是一个简单的修复，有时可以为我们的新团队成员节省一些时间。

【讨论】：

以上是关于如何修复 PHP 中的“标头已发送”错误的主要内容，如果未能解决你的问题，请参考以下文章

如何修复 PHP 中的“标头已发送”错误

WAMP localhost 中的错误“标头已发送”

基于 header(location) 命令重定向 php 页面不起作用；标头已发送错误[重复]

PHP标头已发送[重复]

如何修复wordpress中的php致命错误和http错误500

如何修复 PHP 中的“标头已发送”错误

发送标头前无输出！

为什么会这样？

如何找出过早输出发生的位置？

打印，回显

原始 HTML 区域

&lt;?php 之前的空格用于“script.php line 1”警告

UTF-8 物料清单

更正实用程序

?&gt; 后面的空格

提到的错误源为“第 0 行未知”

前面的错误消息

没有错误信息

输出缓冲作为一种解决方法

但它在另一台服务器上工作！？

检查headers_sent()

HTML &lt;meta&gt; 标签

javascript 重定向

为什么setcookie()和session_start()也会受到影响

更多链接

常见问题：

`<?php` 之前的空格用于“script.php line 1”警告

`?>` 后面的空格

检查`headers_sent()`

HTML `<meta>` 标签

为什么`setcookie()`和`session_start()`也会受到影响