萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

徹底解決 PHP "Cannot modify header information - headers already sent" 錯誤:原理分析與三大解決方案

錯誤根因:HTTP 協定與 PHP 輸出機制

HTTP 回應結構:Header 區塊 → 空行 → Body 區塊。PHP 腳本執行時:

  1. Header 相關函數(header()、setcookie()、session_start())將標頭存入內部清單,不立即發送。
  2. 遇到任何非標頭輸出(HTML 空白、echo、print、BOM、錯誤訊息),PHP 被迫:
    ① 發送所有已儲存 Header
    ② 發送分隔空行
    ③ 發送 Body 內容
  3. 此後任何修改 Header 的嘗試都會觸發此錯誤。

方案一:啟用輸出緩衝 (output_buffering) - 推薦

方法 A:修改 php.ini (需伺服器管理權限)

output_buffering = On
; 或指定緩衝大小(位元組)
output_buffering = 4096

IIS + PHP 必須設為 On,否則效能極差。

方法 B:.htaccess (虛擬主機/無 php.ini 權限)

AllowOverride All
php_flag output_buffering On

若導致 500 錯誤,請聯繫主機商開啟 AllowOverride。

方法 C:腳本內啟用 (通用、無需權限)

<?php
// 檔案最頂端,任何輸出之前
ob_start(); 

// ... 所有業務邏輯、HTML 輸出 ...

// 結束時自動發送緩衝內容,或手動控制:
ob_end_flush();  // 發送緩衝並關閉
// ob_end_clean(); // 僅清除緩衝不發送
?>

方案二:程式碼結構重組(根治)

  • 嚴格分離: 所有邏輯處理(資料庫、Session、Header 設定)置於檔案最前端,HTML 輸出置於最後。
  • 模板引擎: 採用 Twig、Blade、Smarty 等,天然分離邏輯與視圖。
  • 移除 BOM: 以 UTF-8 without BOM 編碼儲存 PHP 檔案。
  • 檢查 include/require: 被引入檔案不得有輸出(含結尾 ?> 後的換行)。

方案三:錯誤抑制 (治標不治本,不推薦)

error_reporting(E_ALL & ~E_NOTICE); // 僅隱藏警告,問題依然存在

輸出緩衝進階 API

函數用途
ob_start()啟用緩衝,支援多層巢狀
ob_get_contents()取得目前緩衝內容字串
ob_end_flush()發送緩衝並關閉
ob_end_clean()清除緩衝不發送並關閉
ob_get_clean()取得內容並清除緩衝 (常用於捕獲輸出)

除錯技巧

<?php
// 快速定位輸出來源
headers_sent($file, $line);
echo "Header 已於 $file 第 $行 發送";
?>

將此碼置於報錯行之前即可精確定位「誰」過早輸出。

copyright © 萬盛學電腦網 all rights reserved