如何在PHP MySQL查询执行前先将echo内容输出到浏览器

这个现象是PHP、Web服务器两层输出缓冲机制共同导致的：你调用echo输出的内容不会立刻发送到浏览器，会先暂存到缓冲区，只有缓冲区填满、脚本执行完成、或者主动触发缓冲刷新操作时，内容才会推送到浏览器端渲染。你执行的长查询阻塞了脚本后续流程，缓冲一直没有被刷新，所以两个提示会同时出现。

修复步骤 #

1. 前置配置调整 #

在脚本最开头添加以下代码，关闭默认的缓冲限制、避免脚本超时：

// 关闭输出压缩，压缩功能会强制缓冲直到内容完整生成
ini_set('zlib.output_compression', 'Off');
// 清空并关闭PHP默认开启的输出缓冲区
if (ob_get_level()) ob_end_clean();
// 取消PHP脚本最大执行时间限制，适配30分钟以上的长查询
set_time_limit(0);

2. 输出提示后主动刷新缓冲 #

每次输出提示内容后，主动调用刷新方法把缓冲内容推送到浏览器，修改后的完整示例代码如下：

// 前置配置
ini_set('zlib.output_compression', 'Off');
if (ob_get_level()) ob_end_clean();
set_time_limit(0);

// 输出提示
echo "preparing data...";
// 可选：部分浏览器需要收到至少1KB内容才会开始渲染，输出空格凑够阈值
echo str_repeat(' ', 1024);
// 刷新PHP层缓冲区
ob_flush();
// 刷新Web服务器层缓冲区
flush();

// 执行长查询
$var = $link->query("insert into table select * from db.table");

if($var === true){
  echo " preparing data complete ";
}else{
  echo " some error ";
}

注意事项 #

• 如果你使用Nginx作为Web服务器，默认开启了fastcgi_buffering，需要在站点Nginx配置中添加fastcgi_buffering off;后重载配置生效，否则Nginx层的缓冲还是会拦截输出内容。
• 不要开启xdebug等调试扩展，调试扩展会强制禁用输出刷新功能。
• 长耗时任务更推荐用队列异步处理，不要直接在Web请求中执行30分钟的查询，很容易触发Web服务器的超时中断。

内容的提问来源于stack exchange，提问作者user17154837