PHP 輸出緩衝區控制完整指南：ob_flush、flush、ob_implicit_flush 實戰詳解

現象重現

<?php
for ($i = 10; $i > 0; $i--) {
    echo $i;
    flush();
    sleep(1);
}
// 預期：每秒輸出一個數字
// 實際：等 10 秒一次性輸出全部

根本原因：output_buffering

php.ini 中 output_buffering = 4096 (4KB) 導致 PHP 內部緩衝，未達 4KB 或腳本結束不輸出。

三種解決方案

方案一：關閉輸出緩衝

ob_end_clean();  // 或 ob_end_flush()
// 後續 echo + flush() 即可即時輸出

方案二：手動刷新 PHP 緩衝區

for ($i = 10; $i > 0; $i--) {
    echo $i;
    ob_flush();  // 將 PHP 緩衝區資料推送到 Web Server
    flush();     // 將 Web Server 緩衝區資料推送到瀏覽器
    sleep(1);
}

方案三：隱式刷新模式

ob_implicit_flush(true); // 每次輸出自動 flush
for ($i = 10; $i > 0; $i--) {
    echo $i;
    ob_flush(); // 若 output_buffering 開啟仍需此行
    sleep(1);
}

// 或完全關閉緩衝
ob_end_clean();
ob_implicit_flush(true);
for ($i = 10; $i > 0; $i--) {
    echo $i;
    sleep(1);
}

關鍵函數差異對照表

瀏覽器端緩衝行為差異

• Firefox / Chrome / IE：收到資料較快顯示
• Opera (舊版)：需遇到 HTML 標籤才顯示，除非腳本結束
• 現代瀏覽器多支援 multipart/x-mixed-replace 實現動態替換

進階範例：動態進度條 (Firefox 專用)

<?php
header('Content-type: multipart/x-mixed-replace;boundary=endofsection');
print "\n--endofsection\n";

$pmt = ["-", "\\", "|", "/"];
for ($i = 0; $i < 10; $i++) {
    sleep(1);
    print "Content-type: text/plain\n\n";
    print "Part $i\t" . $pmt[$i % 4];
    print "--endofsection\n";
    ob_flush(); flush();
}
print "Content-type: text/plain\n\n";
print "The end\n";
print "--endofsection--\n";

無法使用 ini_set 修改 output_buffering 的原因

腳本啟動時緩衝機制已初始化完成，ini_set() 只影響後續 include/require 的檔案，無法改變當前腳本的緩衝行為。

生產環境最佳實踐

1. 長時間任務：ob_end_clean(); ob_implicit_flush(true); + 定期 echo 進度
2. 大檔案下載：fread 迴圈 + ob_flush(); flush(); 避免記憶體暴增
3. WebSocket/SSE：現代替代方案，更適合雙向即時通訊
4. Nginx 代理：注意 proxy_buffering off; 避免 Nginx 二次緩衝

相關專題

• 《PHP 基本語法入門教程》
• 《PHP 錯誤與異常處理方法總結》
• 《PHP 常用函數與技巧總結》