PHP ob_start 系列函數捕獲標準輸出：CLI 模式下靜默收集輸出內容

PHP ob_start 系列函數捕獲標準輸出：CLI 模式下靜默收集輸出內容

CLI 腳本中預設輸出直接送至終端。若需攔截輸出內容供後續處理（如寫日誌、發郵件、返回 API），需正確使用輸出緩衝函數組合。

關鍵函數對比

正確模式：靜默收集不顯示

<?php
ob_start(); // 開啟緩衝

echo "這行不會顯示在終端\n";
print_r($someArray);
var_dump($object);

// 獲取並清除緩衝，關閉緩衝
$output = ob_get_clean(); 

// $output 現在包含所有輸出內容
file_put_contents('log.txt', $output);
// 或 return $output; 供調用者使用
?>

錯誤示範

<?php
ob_start();
echo "測試";
ob_end_flush(); // 這會將內容輸出到終端！不符合「靜默」需求
?>

進階：多層緩衝巢狀

<?php
ob_start(); // 第 1 層
echo "外層 ";
ob_start(); // 第 2 層
echo "內層 ";
$inner = ob_get_clean(); // 獲取內層，關閉第 2 層
echo "外層結尾 ";
$outer = ob_get_clean(); // 獲取外層(含內層內容)，關閉第 1 層
// $outer = "外層 內層 外層結尾 "
?>

CLI 下的特殊情況

• PHP CLI 直接輸出到 STDOUT，ob_get_clean() 可完全攔截。
• 若腳本被其他程式通過 proc_open() 執行，也可用管道讀取 STDOUT/STDERR，但 ob_* 更簡單。
• php://output 流不受 ob_* 控制，直接寫入底層輸出。

實戰應用場景

• CLI 任務執行結果收集發送郵件/Slack 通知
• 單元測試捕獲輸出斷言
• 動態生成靜態檔案 (HTML/JSON/CSV) 存檔
• 中介層轉換輸出格式 (如加壓縮、加密、簽名)