php默认会将脚本输出的内容先存入输出缓冲区，等缓冲区满或者脚本执行结束后才会统一发送给浏览器，这就导致我们无法实时看到输出内容。要实现实时输出立即刷到浏览器，就需要手动控制缓冲区的刷新逻辑。
php输出缓冲的基本原理
php的输出流程分为两层，一层是php自身的用户输出缓冲，另一层是web服务器（如nginx、apache）的缓冲。当我们调用echo、print等输出函数时，内容会先进入php的用户缓冲区，只有缓冲区被刷新或者脚本结束时，内容才会被发送到服务器的缓冲区，再由服务器发送给浏览器。
要实现实时输出，核心就是要在输出内容后主动刷新php的用户缓冲区，同时尽量绕过服务器的缓冲限制。
核心函数说明
ob_flush函数
该函数的作用是刷新php的用户输出缓冲区，把缓冲区中的内容发送到上一层（服务器缓冲区），但不会关闭缓冲区，后续的输出内容仍然会进入缓冲区。
flush函数
该函数的作用是尝试将当前所有缓冲的输出发送到浏览器，它会刷新服务器层面的缓冲区，让内容尽快到达客户端。
ob_implicit_flush函数
如果调用ob_implicit_flush(true)，php会在每次输出后自动调用flush，不需要手动重复调用，适合需要频繁实时输出的场景。
php实时输出完整步骤
实现实时输出的标准步骤如下：
- 第一步：关闭或者清空php的用户输出缓冲区，确保后续输出不会被缓冲
- 第二步：设置响应头，告诉浏览器不要缓冲内容，尽快渲染接收到的数据
- 第三步：每次输出内容后，依次调用
ob_flush和flush刷新缓冲区 - 第四步：如果输出间隔较短，需要适当添加休眠时间，避免浏览器因为接收速度过快无法及时渲染
完整代码示例
以下是一个每隔1秒输出一次当前时间，并且立即显示在浏览器的示例：
<?php
// 关闭输出缓冲
if (ob_get_level()) {
ob_end_clean();
}
// 设置响应头，禁用浏览器缓冲
header('Content-Type: text/html; charset=utf-8');
header('X-Accel-Buffering: no'); // 针对nginx服务器，关闭代理缓冲
header('Cache-Control: no-cache, no-store, must-revalidate');
header('Pragma: no-cache');
header('Expires: 0');
// 开启自动刷新
ob_implicit_flush(true);
for ($i = 1; $i <= 5; $i++) {
echo "第{$i}次输出，当前时间：" . date('Y-m-d H:i:s') . "<br>";
// 手动刷新缓冲（如果没开ob_implicit_flush需要加上这两行）
// ob_flush();
// flush();
sleep(1); // 休眠1秒，模拟实时输出场景
}
?>
注意事项
- 部分web服务器默认会开启输出缓冲，比如nginx的
proxy_buffering默认是开启的，需要配置proxy_buffering off或者在代码中设置X-Accel-Buffering: no响应头关闭该缓冲。 - 如果php配置了
output_buffering参数，需要确保该值足够小或者设置为Off，否则用户缓冲区还是会生效。 - 浏览器的渲染机制也可能影响实时输出效果，部分浏览器会等待接收到一定长度的内容或者标签闭合后才渲染，适当输出一些空格或者换行可以规避这个问题。
- 实时输出场景不要输出过大的内容块，尽量每次输出少量内容后及时刷新缓冲区，避免缓冲区溢出。
注意：实时输出功能在php以cli模式运行时没有意义，因为cli模式的输出是直接到终端的，不需要缓冲刷新逻辑。
phpflushob_flush实时输出php_buffer修改时间：2026-07-18 22:18:21