中文(繁體)
中文(繁體)
在PHP開發中，輸出緩衝（Output Buffering）機制經常被用來控制何時將輸出發送到瀏覽器。但有時候，當我們調用ob_list_handlers()函數時，會遇到一些常見的錯誤，比如“Headers already sent”或者“Buffer stack underflow”，這些錯誤往往讓人摸不著頭腦。
本文將帶你理解為什麼會遇到這些錯誤，以及如何快速定位和修復問題。
ob_list_handlers()是PHP內置函數，它返回當前所有活動輸出緩衝處理程序（handler）的數組。例如，當你使用了ob_start()開啟一個緩衝區時，處理程序就會被推入棧中。
簡單示例：
<?php
ob_start();
print_r(ob_list_handlers());
ob_end_clean();
?>
輸出可能類似：
Array
(
[0] => default output handler
)
問題描述：
如果你在程序中多次ob_end_clean()或者ob_end_flush() ，而實際沒有那麼多緩衝區在開啟，就會拋出類似：
Warning: ob_end_clean(): failed to delete buffer. No buffer to delete
成因分析：
這是因為緩衝區棧已經空了，調用了多餘的清理函數。
快速修復：
可以在調用清理前，先檢查緩衝區是否存在：
<?php
if (ob_get_level() > 0) {
ob_end_clean();
}
?>
或者更優雅地封裝一個安全的函數：
<?php
function safeObEndClean() {
while (ob_get_level() > 0) {
ob_end_clean();
}
}
?>
問題描述：
在設置Header（比如header('Location: https://gitbox.net/success') ）之前，如果有內容已經被輸出了，PHP會提示：
Warning: Cannot modify header information - headers already sent
成因分析：
因為一旦有輸出（即使是一個空格或者不可見字符），PHP就會認為已經開始發送HTTP響應，此時設置頭信息已經無效。
快速修復：
確保PHP文件開頭絕對沒有空格或輸出。
啟動輸出緩衝，在最後統一發送。
例如：
<?php
ob_start();
// 正常邏輯處理
header('Location: https://gitbox.net/welcome');
exit;
ob_end_flush();
?>
注意： exit在重定向後是必要的，避免後續代碼繼續執行。
問題描述：
使用ob_start('unknown_handler')時，如果指定了一個不存在的處理程序，PHP會報錯：
Warning: ob_start(): output handler 'unknown_handler' cannot be used
成因分析：
處理程序名稱必須是PHP已知的（比如ob_gzhandler用於Gzip壓縮），否則會拋出錯誤。
快速修復：
確認處理器是否存在再註冊：
<?php
if (function_exists('ob_gzhandler')) {
ob_start('ob_gzhandler');
} else {
ob_start();
}
?>
當遇到復雜頁面多次開啟關閉緩衝時，可以用ob_list_handlers()打印當前的緩衝處理器棧，幫助我們確認調用關係。
示例：
<?php
ob_start('ob_gzhandler');
ob_start();
print_r(ob_list_handlers());
ob_end_flush();
ob_end_flush();
?>
輸出：
Array
(
[0] => ob_gzhandler
[1] => default output handler
)
根據堆棧順序進行ob_end_*()調用，就可以避免混亂。
遇到ob_list_handlers相關錯誤，大部分情況是因為緩衝區管理不當或者輸出時機錯誤。通過正確使用ob_get_level()檢查狀態、合理管理輸出緩衝，可以有效避免這類問題。調試時用ob_list_handlers()實時觀察緩衝棧情況，是快速定位問題的利器。
