header('Location: ...')跳轉失效是PHP新手高頻問題。核心原因:**HTTP頭必須在任何輸出(包括空白、BOM、錯誤信息)之前發送**。本文系統排查失效原因,提供輸出緩衝、配置修改、重構代碼三種解決路徑。
echo、print、HTML標籤、空白行、BOM頭。?>後跟空白/換行。display_errors=On導致警告先於header輸出。session_start()若在輸出後調用會發送Cookie頭,導致後續header失敗。| 方案 | 原理 | 優點 | 缺點 | 推薦場景 |
|---|---|---|---|---|
| 輸出緩衝 ob_start() | 將所有輸出暫存內存,腳本結束或ob_end_flush()時統一發送,header可在任意位置調用 | 零侵入、兼容舊代碼 | 增加內存佔用、大響應可能OOM | 快速修復、歷史項目 |
| php.ini output_buffering=4096 | PHP內核級緩衝,自動緩衝前4KB輸出 | 無需修改代碼、性能損耗極小 | 超過4KB仍失效、共享主機無法修改 | 生產環境通用優化 |
| 代碼重構:前置邏輯、後輸出 | 所有header、session、邏輯判斷放在頂部,模板渲染放最後 | 根治、符合MVC分層、零運行開銷 | 需重構、團隊規範 | 新項目、長期維護項目 |
<?php
// 入口文件最頂部(甚至在任何include之前)
ob_start(); // 開啟緩衝
// 業務邏輯:認證、跳轉、設置Cookie等
if (!isset($_SESSION['user'])) {
header('Location: /login.php');
exit;
}
// 模板渲染(輸出HTML)
include 'header.php';
include 'content.php';
include 'footer.php';
ob_end_flush(); // 可省略,腳本結束自動刷新
// 臨時開啟錯誤顯示定位輸出源頭
ini_set('display_errors', 1);
error_reporting(E_ALL);
// 或使用headers_sent()檢測
if (headers_sent($file, $line)) {
error_log("Headers already sent in $file:$line");
}
ob_start()或配置output_buffering=4096。?>**,防止尾部空白。display_errors,啟用log_errors。遵循「邏輯先行、輸出在後」原則,徹底消除header跳轉失效隱患。