// 1. 禁用輸出緩衝
@ini_set('output_buffering', '0');
@ini_set('zlib.output_compression', '0');
// 2. 清除並關閉現有緩衝區
while (ob_get_level()) { ob_end_clean(); }
// 3. 開啟隱式刷新:每次 echo/print 直接發送到瀏覽器
ob_implicit_flush(true);
// 4. 設置無限執行時間(僅 CLI 或確安全的 Web 環境)
set_time_limit(0);
// 5. 發送必要 Header(防止代理/瀏覽器緩存)
header('Content-Type: text/html; charset=utf-8');
header('X-Accel-Buffering: no'); // 禁用 Nginx fastcgi_buffering
header('Cache-Control: no-cache, must-revalidate');
header('Connection: keep-alive');
ob_end_clean();
ob_implicit_flush(1);
for ($i = 1; $i <= 10; $i++) {
// 部分瀏覽器需最小內容長度才渲染,填充空白
echo str_repeat(' ', 1024) . "步驟 $i 完成
\n";
sleep(1);
}
echo "全部完成!";
// SSE 格式:每條數據以 "data: ...\n\n" 結尾
function sseSend($data, $event = null, $id = null) {
if ($id !== null) echo "id: $id\n";
if ($event !== null) echo "event: $event\n";
echo "data: " . json_encode($data, JSON_UNESCAPED_UNICODE) . "\n\n";
// 立即刷新
@ob_flush(); @flush();
}
// 使用範例
sseSend(['step' => 1, 'msg' => '初始化...'], 'progress', 1);
sleep(1);
sseSend(['step' => 2, 'msg' => '處理中...'], 'progress', 2);
sleep(1);
sseSend(['step' => 3, 'msg' => '完成'], 'done', 3);
| 現象 | 原因 | 解決 |
|---|---|---|
| 瀏覽器一直不顯示,直到腳本結束 | Nginx/Apache 模塊緩衝、瀏覽器最小渲染閾值 | 加 header('X-Accel-Buffering: no');echo str_repeat(' ', 1024) 填充 |
| 中文亂碼 | 編碼不一致 | 文件保存為 UTF-8 無 BOM;header('Content-Type: text/html; charset=utf-8') |
| FastCGI 進程超時(502/504) | Nginx fastcgi_read_timeout 過短 | 調大 Nginx 配置或改用異步任務隊列 |
| 內存耗盡 | 大量數據未釋放 | 分塊處理、unset() 大變量、gc_collect_cycles() |
// CLI 默認無輸出緩衝,僅需:
for ($i=1; $i<=10; $i++) {
echo "\r進度: $i/10"; // \r 回車覆蓋同一行
sleep(1);
}
echo "\n完成\n";
PHP 即時輸出的關鍵在於「關閉所有緩衝層 + 顯式刷新」。Web 環境下受限於 Web Server、代理、瀏覽器多層緩衝,建議核心邏輯採用異步任務 + 前端輪詢/SSE/WebSocket,僅在 CLI 或內部管理介面使用即時輸出。