本文深入探讨了PHP `header()` 函数重定向失败的常见原因，特别是“Headers already sent”错误，以及字节顺序标记（BOM）等隐蔽问题。文章提供了多种解决方案，包括启用输出缓冲、始终在 `header()` 调用后使用 `exit()`，以及在极端情况下利用 HTML `meta` 刷新标签作为可靠的备用重定向机制，旨在帮助开发者构建更健壮的PHP应用。
在PHP中，header() 函数用于发送原始 HTTP 头，常用于重定向用户到另一个页面。然而，header() 函数有一个严格的限制：它必须在任何实际输出发送到浏览器之前被调用。这里的“输出”包括 HTML 内容、空格、换行符，甚至是文件开头的字节顺序标记（BOM）。一旦任何输出被发送，HTTP 头就无法再被修改，此时尝试调用 header() 就会导致臭名昭著的“Cannot modify headers. Headers already sent by...”错误。
这个错误可能由于多种原因导致：
当遇到 header() 重定向不生效的问题时，首先应检查以下几点：
立即学习“PHP免费学习笔记（深入）”；
针对 header() 重定向失败的问题，有多种解决方案和最佳实践：
输出缓冲是解决“Headers already sent”问题最常用且有效的方法之一。它允许PHP在将输出发送到浏览器之前，先将其存储在服务器的内存缓冲区中。这样，即使在 header() 调用之前有输出，这些输出也会被缓冲，直到脚本执行完毕或缓冲区被明确刷新。
通过 php.ini 配置： 在 php.ini 文件中设置 output_buffering = on 或指定一个缓冲区大小，例如 output_buffering = 4096。这会全局启用输出缓冲。
在脚本中手动控制： 在PHP脚本的开头使用 ob_start() 函数开启输出缓冲，并在脚本的末尾使用 ob_end_flush() 或 ob_end_clean() 来发送或丢弃缓冲区内容。
<?php
ob_start(); // 开启输出缓冲
// 你的所有PHP代码，包括可能产生输出的部分
// ...
if (/* 条件满足需要重定向 */) {
header("Location: /target_page.php");
exit(); // 始终在header()后使用exit()
}
ob_end_flush(); // 发送并关闭输出缓冲
?>这是一个非常重要的最佳实践。header() 函数仅仅发送 HTTP 头，它并不会停止脚本的执行。如果脚本继续执行并产生了其他输出，那么即使 header() 调用成功，用户也可能在重定向发生前看到这些额外的输出，或者甚至重定向被后续代码的输出所干扰。因此，在 header() 调用之后立即使用 exit() 或 die() 来终止脚本执行是至关重要的。
if (password_verify($_POST['password'], $db_password)) {
$_SESSION['loggedin'] = true;
$_SESSION['username'] = $_POST['username'];
$_SESSION['userid'] = $row['id'];
header("Location: ../home.php");
exit(); // 确保重定向后脚本立即停止
} else {
header("Location: ../login.php");
exit(); // 确保重定向后脚本立即停止
}在某些极端情况下，例如服务器配置无法修改，或者 header() 函数由于某种未知原因始终无法工作时，可以使用 HTML 的 meta 刷新标签作为一种备用重定向方案。这种方法不依赖于 HTTP 头，而是通过在发送给浏览器的 HTML 内容中包含一个特殊的 meta 标签来指示浏览器在指定时间后重定向。
exit('<meta http-equiv="Refresh" content="0;url=../login.php"/>');这里的 content="0;url=../login.php" 表示浏览器在0秒后（即立即）跳转到 ../login.php 页面。将此代码与 exit() 结合使用，可以在 header() 失败时提供一个可靠的降级方案。
结合上述最佳实践，我们可以对原有的登录认证脚本进行优化，使其重定向逻辑更加健壮。
<?php
# Authenticator
// 推荐在所有输出之前开启输出缓冲
// ob_start();
include("../server/conn.php");
// 启动Session，确保$_SESSION可用
session_start();
$required = array('username', 'password');
if(isset($_POST['submit'])){
$error = false;
foreach($required as $field) {
if (empty($_POST[$field])) {
$error = true;
// 可以在这里设置一个错误消息到session或URL参数，以便login.php显示
}
}
if ($error) {
header("Location: ../login.php?error=empty_fields");
// 如果header()失败，提供meta refresh作为备用
exit('<meta http-equiv="Refresh" content="0;url=../login.php?error=empty_fields"/>');
} else {
$getuserpassword = $conn->prepare('SELECT * FROM users WHERE username = ?');
$getuserpassword->bind_param("s", $_POST['username']);
$getuserpassword->execute();
$getres1 = $getuserpassword->get_result();
if ($getres1->num_rows > 0) {
while ($row = $getres1->fetch_assoc()) {
$db_password = $row['password'];
if (password_verify($_POST['password'], $db_password)) {
$_SESSION['loggedin'] = true;
$_SESSION['username'] = $_POST['username'];
$_SESSION['userid'] = $row['id'];
header("Location: ../home.php");
exit(); // 成功登录后立即终止脚本并重定向
} else {
header("Location: ../login.php?error=invalid_credentials");
// 密码不匹配时，提供meta refresh作为备用
exit('<meta http-equiv="Refresh" content="0;url=../login.php?error=invalid_credentials"/>');
}
}
} else {
// 用户名不存在
header("Location: ../login.php?error=invalid_credentials");
exit('<meta http-equiv="Refresh" content="0;url=../login.php?error=invalid_credentials"/>');
}
}
} else {
// 如果没有通过POST submit提交，可能直接访问了此文件
header("Location: ../login.php");
exit('<meta http-equiv="Refresh" content="0;url=../login.php"/>');
}
// 如果启用了ob_start()，在这里关闭
// ob_end_flush();
?>重要提示：
解决PHP header() 重定向失败的关键在于理解 HTTP 协议中头信息发送的限制。通过以下实践，可以有效避免此类问题：
遵循这些原则将帮助您构建更稳定、更可靠的PHP应用程序。
以上就是解决PHP header() 重定向失败：原理、原因与实践的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
295
收藏
