PHP 輸出緩沖控制 (Output Control) 深度解析與實戰技巧

掌握 PHP 輸出緩沖：從原理到實戰的完整指南

PHP 輸出緩沖是理解「為什麼 header() 可以在 echo 之後調用」、「如何實現漸進式輸出」的關鍵。本文深度解析三級緩沖架構、核心函數差異、瀏覽器兼容性陷阱與調試技巧。

三級緩沖架構

PHP 腳本 → PHP Buffer (output_buffering) → Web Server Buffer (Apache/Nginx) → Browser Buffer → 用戶可見

• PHP Buffer：默認開啟，默認 4096 字節（output_buffering = 4096），可在 php.ini 配置
• Web Server Buffer：Apache mod_gzip、Nginx fastcgi_buffering 等
• Browser Buffer：IE 需 256 字節才開始渲染，Chrome/Firefox 相對積極

核心函數詳解

經典案例：header() 為何能在 echo 後調用？

<?php
echo "南無阿彌陀佛<br>";
header("Content-Type: text/html; charset='utf-8'");
echo "真善忍好!";
// 正常輸出，因為 PHP Buffer 尚未刷新到 Web Server
?>

但若手動刷新：

<?php
echo "南無阿彌陀佛<br>";
ob_flush(); // 強制刷新 PHP Buffer
header("Content-Type: text/html; charset='utf-8'"); // 錯誤：headers already sent
echo "真善忍好!";
?>

實現漸進式輸出（長連接/流式響應）

<?php
// 關鍵：填滿瀏覽器緩沖區門檻
echo str_pad('', 4096) . "\n"; // 或 256 字節針對 IE

for ($i = 10; $i > 0; $i--) {
    echo $i . "<br>";
    ob_flush(); // PHP 層
    flush();    // Web Server 層
    sleep(1);
}
?>

完整模板：

<?php
// 1. 禁用壓縮（否則 Web Server 會緩存壓縮後再發送）
@apache_setenv('no-gzip', 1);
@ini_set('zlib.output_compression', 0);
@ini_set('output_buffering', 'Off');

// 2. 發送足夠填充
echo str_repeat(' ', 4096);

// 3. 循環輸出 + 雙重刷新
foreach ($data as $item) {
    echo $item . "<br>";
    ob_flush();
    flush();
    usleep(100000); // 微秒延遲
}
?>

常見陷阱與解決

• Nginx fastcgi_buffering：默認開啟，需在 location 中設置 fastcgi_buffering off;
• Apache mod_gzip/mod_deflate：會緩存壓縮輸出，需關閉或發送足夠數據觸發刷新
• IE 瀏覽器：必須發送 256+ 字節才開始渲染，用 str_pad 填充
• 隱式緩沖：ob_start() 會疊加，注意嵌套調用