刷新系统缓冲区

输出刷新行为

在禁用隐式刷新时，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 服务器/浏览器/控制台的缓冲区设置并使用这些设置可以缓解可能出现的问题。在 Web 上下文中，可以调整 Web 服务器的缓冲区设置或脚本的缓冲区设置以协同工作，而通过调整 PHP 脚本中的缓冲区可以解决各种浏览器的缓冲区策略。在实现行缓冲的控制台上，可以在刷新输出之前在适当的位置插入换行符。

SAPI 中刷新的差异

尽管每个 SAPI 都以略微不同的方式实现刷新，但这些实现都属于以下两类之一

• 在 Web 上下文中使用的 SAPI 将首先刷新标头，然后刷新输出。 Apache2Handler、CGI、FastCGI 和 FPM 就是此类 SAPI
• 其他 SAPI（例如 CLI 和 embed）将仅刷新输出