清空系統緩衝區

輸出清空行為

停用隱式清空時，PHP 只會在呼叫 flush() 或腳本結束時清空輸出。

啟用隱式清空時，PHP 會在每個產生輸出的程式碼區塊後嘗試清空。此處的輸出是指長度非零且

• 位於 <?php ?> 標籤之外的資料
• 由語言結構和函式印出，這些結構和函式的明確目的是輸出使用者提供的變數或字串，例如 echo、print、printf()、var_dump()、var_export()、vprintf()
• 由函式印出，這些函式的目的是收集和輸出關於正在執行的腳本或 PHP 的數據/資訊，例如 debug_print_backtrace()、phpcredits()、phpinfo()、ReflectionExtension::info()
• 由 PHP 在未捕獲的異常或未處理的錯誤時印出（取決於 display_errors 和 error_reporting 的設定）
• 任何寫入到 php://output 的內容

注意： 印出空字串或發送標頭不被視為輸出，不會導致刷新操作。

限制

此功能無法刷新使用者層級的輸出緩衝區。要將它們一起使用，必須先刷新使用者層級的輸出緩衝區，然後再刷新系統緩衝區，才能讓 PHP 產生任何輸出。

底層軟體/硬體實現的緩衝機制無法被 PHP 覆蓋，在使用 PHP 的緩衝控制函式時應將其納入考量。檢查網路伺服器/瀏覽器/控制台的緩衝設定並配合這些設定可以減輕潛在的問題。在 Web 環境中工作時，可以調整網路伺服器的緩衝設定或腳本的緩衝設定以協同工作，而解決各種瀏覽器的緩衝策略則可以通過調整 PHP 腳本中的緩衝來實現。在實現行緩衝的控制台上，可以在刷新輸出之前在適當的位置插入換行符。

SAPI 刷新差異

雖然每個 SAPI 的刷新實現方式略有不同，但這些實現都屬於以下兩種類型之一

• 在 Web 環境中使用的 SAPI 會先刷新標頭，然後再刷新輸出。Apache2Handler、CGI、FastCGI 和 FPM 都是這類 SAPI。
• 其他 SAPI，例如 CLI 和 embed，只會刷新輸出。