header()重定向必须在任何输出前调用,否则报“headers already sent”错误;需搭配exit终止脚本;推荐使用绝对路径如'/login.php';调试可用headers_sent()定位输出源。

PHP 中 header() 重定向必须在输出前调用
如果页面已有任何输出(包括空格、换行、 标签、echo、print),header() 就会报错:Warning: Cannot modify header information - headers already sent。
常见踩坑点:
- PHP 文件开头有 BOM 字节(尤其 Windows 编辑器保存时默认带 BOM)
前有空行或空格- 引入的配置文件末尾有多余换行或空行
- 错误开启了
output_buffering但没理解其作用边界
最稳妥做法:确保重定向逻辑放在脚本最前面,且所有前置文件(如 require 'config.php';)不产生任何输出。
正确写法:用 header() + exit 组合
header('Location: /login.php'); 只是发送 HTTP 头,PHP 不会自动终止脚本执行。后续代码仍会运行,可能造成逻辑混乱或安全风险(比如跳转后还继续执行数据库操作)。
务必配对使用:
header('Location: /dashboard.php');
exit;
其他等效写法(效果一致,但语义更明确):
die();exit(0);-
http_response_code(302); header('Location: ...');(显式设状态码,非必需但更规范)
相对路径和绝对路径在 Location 头里的行为差异
header('Location: login.php') 是相对重定向,浏览器会基于当前 URL 路径拼接,容易出错。例如访问 /admin/user/edit.php 时跳转到 login.php,实际目标是 /admin/user/login.php,而非预期的根目录下 /login.php。
推荐统一用绝对路径(以 / 开头):
-
header('Location: /login.php');→ 正确,指向根目录 -
header('Location: https://example.com/logout');→ 支持跨域,但需注意 HTTPS 安全性 - 避免
header('Location: ./login.php')或../login.php,路径计算不可控
如果项目部署在子目录(如 https://example.com/myapp/),建议通过 $_SERVER['SCRIPT_NAME'] 或配置常量动态构造基础路径,而不是硬编码 /myapp/login.php。
调试时如何确认 header() 是否生效
浏览器开发者工具的 Network 面板里看不到跳转后的页面请求?那很可能重定向根本没发出去——问题出在头已发送或语法错误。
快速验证方法:
- 临时加
var_dump(headers_sent($file, $line)); echo "$file:$line";查哪行/哪个文件提前输出了 - 用
headers_list()打印当前已发送的头,确认Location是否在其中 - 禁用所有
echo/var_dump,只留重定向逻辑,再逐步放开排查
注意:header() 在 CLI 模式下无效,仅适用于 Web SAPI(如 Apache、FPM)。
重定向看着简单,但路径拼接、输出控制、脚本终止这三个环节,任何一个松动都会让跳转失败或埋下安全隐患。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











