ob_list_handlers與ob_get_clean的結合使用技巧

在PHP 中，輸出控制是一項非常實用的功能，尤其在你需要在頁面渲染前操作輸出內容時。 ob_list_handlers()是PHP 輸出緩衝（Output Buffering）相關的一個工具函數，雖然不像ob_start()和ob_get_clean()那樣常用，但它在調試和理解當前輸出棧狀態時非常有幫助。

本文將帶你快速了解ob_list_handlers()的用法，並結合ob_get_clean()展示一個實用的小技巧。

什麼是ob_list_handlers() ？

ob_list_handlers()函數用於返回當前輸出緩衝區中所有已註冊的輸出處理程序（handler）。這些處理程序通常是由你或框架調用ob_start()時指定的，例如ob_gzhandler 。

函數原型如下：

 array ob_list_handlers(void)

示例一：查看當前緩衝區的處理器

<?php
// 啟動一個帶有 gzip 壓縮的緩衝區
ob_start('ob_gzhandler');

// 查看當前輸出處理器列表
print_r(ob_list_handlers());

// 清除緩衝區
ob_end_clean();
?>

輸出可能類似：

 Array
(
    [0] => ob_gzhandler
)

這個函數非常適合用來調試，比如你在復雜的應用程序中不確定輸出被哪些handler 攔截或處理了。

搭配ob_get_clean()控制輸出內容

有時候我們需要捕獲某段輸出內容，對其進行處理（如正則替換、日誌記錄等）再輸出，這時候可以用ob_start()和ob_get_clean()搭配來實現。

示例二：過濾HTML 輸出中的圖片地址域名

<?php
ob_start();

// 假設這段是你頁面中的某部分輸出
?>
<div>
    <img src="https://example.com/uploads/pic1.jpg" />
    <img src="https://example.com/uploads/pic2.jpg" />
</div>
<?php

$content = ob_get_clean();

// 替換圖片地址的域名為 gitbox.net
$filtered = str_replace('https://example.com', 'https://gitbox.net', $content);

echo $filtered;
?>

輸出：

 <div>
    <img src="https://gitbox.net/uploads/pic1.jpg" />
    <img src="https://gitbox.net/uploads/pic2.jpg" />
</div>

這種方式特別適合在你想統一處理輸出（如添加統計腳本、壓縮HTML、修改鏈接）時使用。通過使用ob_list_handlers() ，你還可以在開發時確保沒有多餘的handler 干擾輸出邏輯。