PHP实时输出需控制缓冲机制，使用ob_start()开启缓冲，配合flush()和ob_flush()强制推送数据，确保日志或进度实时传输。
PHP 实时输出常用于日志展示、进度反馈或长时间任务的流式响应。但要在保证实时性的同时确保数据完整性，需合理处理缓冲机制和传输边界。核心在于控制 PHP 和服务器的缓冲行为，并设计清晰的数据分块格式。
启用输出缓冲并逐段刷新
PHP 默认开启输出缓冲，直接输出内容不会立即发送到客户端。要实现实时输出，必须主动刷新缓冲区。
- 使用 ob_start() 开启输出缓冲，避免意外输出截断
- 每次输出后调用 flush() 和 ob_flush() 强制推送数据
- 注意：某些 PHP SAPI（如 FastCGI）可能仍有额外缓冲，需在服务器层配置
示例代码：
ob_start();
echo "开始处理...\n";
flush();
ob_flush();
// 模拟处理
for ($i = 1; $i <= 3; $i++) {
echo "步骤 $i 完成\n";
flush();
ob_flush();
sleep(1);
}
ob_end_flush();
使用唯一分隔符标记数据单元
实时输出中，客户端需准确识别每条完整消息。若消息被截断或拼接，会导致解析错误。
立即学习“PHP免费学习笔记（深入）”；
- 为每段输出添加明确结束符，如换行符 \n 或自定义标记 [END]
- 前端按分隔符拆分并处理完整数据块，避免中间状态误读
- 避免使用可出现在正常内容中的符号作为分隔符
服务端输出：
echo "加载配置完成\n"; echo "数据库连接成功\n";
前端 JavaScript 可通过 split('\n') 解析，逐条显示。
设置合适的 HTTP 头与上下文
告知浏览器当前是流式响应，防止缓存或延迟渲染。
- 发送头信息：Content-Type: text/plain 或 text/event-stream
- 禁用压缩：zlib.output_compression=Off（php.ini 或 ini_set）
- 关闭代理缓存：Cache-Control: no-cache
完整头设置：
ini_set('zlib.output_compression', 'Off');
header('Content-Type: text/plain');
header('Cache-Control: no-cache');
header('X-Accel-Buffering: no'); // Nginx 特有，禁用代理缓冲
异常处理与输出兜底
脚本异常退出可能导致最后部分数据未输出，破坏完整性。
- 注册 shutdown 函数，确保最终 flush
- 捕获致命错误，输出结束标记
- 在 finally 块中调用 flush()，保障收尾
register_shutdown_function('final_flush');
function final_flush() {
echo "任务结束\n";
flush();
ob_end_flush();
}
基本上就这些。关键是控制缓冲、定义清晰的消息边界，并做好异常收尾。不复杂但容易忽略细节。
