萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實現即時輸出(Real-time Output)完整方案

應用場景

  • 長時間運行的 CLI/腳本任務進度顯示
  • 大文件導出、數據遷移、視頻轉碼等需實時反饋的 Web 操作
  • Server-Sent Events (SSE) 簡易實現

核心原理:關閉緩衝、隱式刷新

// 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 格式

// 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 環境下的簡化寫法

// CLI 默認無輸出緩衝,僅需:
for ($i=1; $i<=10; $i++) {
    echo "\r進度: $i/10"; // \r 回車覆蓋同一行
    sleep(1);
}
echo "\n完成\n";

結語

PHP 即時輸出的關鍵在於「關閉所有緩衝層 + 顯式刷新」。Web 環境下受限於 Web Server、代理、瀏覽器多層緩衝,建議核心邏輯採用異步任務 + 前端輪詢/SSE/WebSocket,僅在 CLI 或內部管理介面使用即時輸出。

copyright © 萬盛學電腦網 all rights reserved