基於 flush() 無法順序輸出的解決方案

PHP 輸出緩衝控制：實現即時分批輸出

使用 flush() 實現長時間任務的進度即時輸出時，常因輸出緩衝機制導致內容一次性輸出。本文提供 Linux/Windows 環境下的完整解決方案。

核心問題

• PHP 輸出經過：PHP 緩衝 → Web 伺服器緩衝 → 瀏覽器緩衝
• 需依次關閉/刷新各層緩衝才能即時輸出

方案一：標準 ob_start + ob_flush + flush 組合

<?php
ob_start(); // 開啟 PHP 輸出緩衝
for ($i = 1; $i <= 10; $i++) {
    echo $i . "<br />\n";
    ob_flush(); // 刷新 PHP 緩衝到 Web 伺服器
    flush();    // 刷新 Web 伺服器緩衝到瀏覽器
    usleep(500000); // 模擬耗時任務 (0.5秒)
}

方案二：添加 Header 強制關閉壓縮/緩衝（針對無效情況）

<?php
header("Content-Type: text/html; charset=utf-8");
// 關鍵：禁用 gzip 壓縮，否則輸出會被壓縮緩衝
header("X-Accel-Buffering: no"); // Nginx 禁用緩衝
header("Cache-Control: no-cache");

ob_start();
for ($i = 1; $i <= 10; $i++) {
    echo $i . "<br />\n";
    ob_flush();
    flush();
    usleep(500000);
}

環境配置要點

進階技巧：輸出填充觸發瀏覽器渲染

// 在迴圈前輸出足夠填充
echo str_repeat(' ', 1024); 
// 或輸出隱藏 HTML 註釋
echo '<!-- ' . str_repeat(' ', 1024) . ' -->';

常見誤區

• ❌ 僅用 flush() 不用 ob_flush()：PHP 緩衝未刷新
• ❌ 開啟 gzip 壓縮：輸出被壓縮緩衝，無法即時傳輸
• ❌ 忽略 Web 伺服器緩衝配置：Nginx/Apache 預設緩衡 FastCGI 輸出

按環境依次排查配置，即可實現真正的即時輸出效果。