萬盛學電腦網

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

PHP flush() 輸出不生效?ob_start/ob_flush/flush 協作機制詳解

現象

循環中 echo + flush() 期望逐行輸出,實際**頁面載入完一次性輸出**,或根本無輸出。

緩衝層級說明

  1. PHP 內部輸出緩衝:ob_start() 開啟,ob_flush() 刷新到 SAPI 層。
  2. SAPI/Web 服務器緩衝:Nginx/Apache 可能再緩衝(fastcgi_buffering、proxy_buffering)。
  3. 瀏覽器緩衝:需輸出足夠字節(通常 > 256-1024 bytes)才開始渲染。

標準協作代碼模板

<?php
// 1. 禁用所有緩衝(僅 CLI 或確確定定無上層緩衝時)
// ini_set('output_buffering', '0'); // php.ini 或 .user.ini 設置

// 2. 開啟 PHP 輸出緩衝並禁用隱式緩衝
ob_start();
ob_implicit_flush(true); // 每次輸出自動 flush(僅影響 PHP 層)

// 3. 發送足夠填充數據觸發瀏覽器渲染(可選)
echo str_repeat(' ', 1024); // 1KB 空白

for ($i = 1; $i <= 10; $i++) {
    echo "$i
\n"; ob_flush(); // 1. PHP 緩衝 -> SAPI flush(); // 2. SAPI -> Web Server -> 客戶端 usleep(500000); // 0.5 秒演示 } ob_end_flush();

Nginx + PHP-FPM 必須關閉的緩衝配置

Nginx 站點配置:

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
    # 關鍵:關閉 fastcgi 緩衝,否則 flush() 無效
    fastcgi_buffering off;
    fastcgi_request_buffering off;
}

PHP-FPM 池配置 (www.conf):

; 確保不強制緩衝
; 默認即為 off,無需改動

Apache + mod_php / mod_proxy_fcgi

  • mod_php:php_value output_buffering 0 在 .htaccess/vhost。
  • mod_proxy_fcgi:同 Nginx,設置 proxy_buffering off。

常見失效原因排查表

現代替代:Server-Sent Events (SSE) / WebSocket

長連接、雙向、瀏覽器原生支持,比輪詢/flush 更優雅:

<?php // sse.php
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
header('X-Accel-Buffering: no'); // 禁用 Nginx 緩衝

$lastId = isset($_SERVER['HTTP_LAST_EVENT_ID']) ? (int)$_SERVER['HTTP_LAST_EVENT_ID'] : 0;
for ($i = $lastId + 1; $i <= $lastId + 10; $i++) {
    echo "id: $i\n";
    echo "data: {\"msg\": \"Message $i\"}\n\n";
    ob_flush(); flush();
    sleep(1);
}

前端:new EventSource('/sse.php')。

copyright © 萬盛學電腦網 all rights reserved
原因檢查/解決
php.ini output_buffering = 4096 (默認開啟)改為 Off 或腳本首行 ob_end_clean(); ob_implicit_flush(true);
Nginx fastcgi_buffering on (默認)場所配置添加 fastcgi_buffering off; 並 reload
瀏覽器等待最小字節數輸出 str_repeat(' ', 1024) 填充
gzip 壓縮導致緩衝Nginx gzip off; 或 PHP zlib.output_compression = Off
防病毒/防火牆攔截流式響應排除應用端口、關閉 HTTP 檢查
輸出內容含有未閉合表格/標籤瀏覽器不渲染不完整結構,改用 div 或確保標籤閉合