如何正确使用 PHP 的 header() 函数实现页面重定向-php教程-PHP中文网

如何正确使用 PHP 的 header() 函数实现页面重定向

PHP 中 header("Location: ...") 重定向失败通常是因为响应头已发送（如存在输出、空格、BOM 或错误提示），导致 HTTP 头无法修改；必须确保调用前无任何输出，并在 header() 后立即执行 exit 或 die。

php 中 `header("location: ...")` 重定向失败通常是因为响应头已发送（如存在输出、空格、bom 或错误提示），导致 http 头无法修改；必须确保调用前无任何输出，并在 `header()` 后立即执行 `exit` 或 `die`。

在 PHP 中，header() 函数用于向客户端发送原始 HTTP 头信息，其中 Location 头是最常用的重定向机制。但它的使用有严格前提：必须在任何实际输出（包括 HTML、空白字符、PHP 错误提示、echo/print、甚至文件末尾的换行符）之前调用。一旦 PHP 开始输出响应体（即 HTTP body），服务器就已隐式发送响应头，此时再调用 header() 将直接失败，并触发 “Cannot modify header information – headers already sent” 警告。

常见导致重定向失效的原因包括：

文件开头或结尾存在不可见的 UTF-8 BOM 字节；
后有多余空格、换行或空行；
在 header() 前执行了 echo、var_dump()、print_r() 等输出语句；
启用了 display_errors = On，PHP 错误（如 Notice、Warning）被直接输出到浏览器；
包含的其他文件（如 config.php、db.php）中存在意外输出。

✅ 正确写法示例（登录验证后跳转）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php session_start();

// 假设已连接数据库并执行查询，$row 来自合法结果集
if ($row['idUsuario'] === $_POST['username'] 
    && $row['password'] === $_POST['password'] 
    && $row['nivel'] == 2) {

    $_SESSION['sesion_coordinador'] = 'creada';
    $_SESSION['coordinador'] = $id_usuario;

    // ✅ 使用绝对路径更可靠（推荐）
    header('Location: /coordinador-login.php');
    exit; // ⚠️ 必须终止脚本，防止后续代码执行
}
?>

? 关键注意事项：

路径建议用绝对 URL 路径（以 / 开头），如 /coordinador-login.php，避免相对路径因当前 URL 深度不同而跳转错误；
始终在 header() 后紧跟 exit 或 die()，否则脚本将继续执行，可能造成逻辑混乱或安全风险；
不要依赖 ob_start() 作为补救手段：虽然输出缓冲（Output Buffering）可延迟发送，但它掩盖了根本问题（如不规范的输出习惯），且在生产环境可能被禁用或配置受限；
开启错误报告时务必关闭 display_errors（设为 Off），改用日志记录，避免错误信息污染响应头；
检查所有被包含文件：使用 require_once 或 include_once 并逐个确认无输出。

? 提示：开发阶段可在入口文件顶部统一启用输出缓冲（仅作临时调试）：

<?php ob_start(); // 放在最顶部，早于 session_start() 和任何输出
session_start();
// ... 其他逻辑

但请勿将其视为长期解决方案——应彻底清理输出源头，保障代码健壮性与可维护性。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！