PHP批量发邮件长任务如何实现实时进度指示器(原flush法失效)
传统
flush()实时输出失效的核心原因 - 现代Web服务器(Nginx、新版Apache)默认开启多层输出缓冲,不会把PHP推送的内容立刻转发给浏览器
- 浏览器自身也有预渲染缓冲,一般要收到1KB~数KB的完整内容才会开始解析渲染
- PHP默认配置开启的
output_buffering、zlib.output_compression,会把所有输出在服务端攒到阈值后才统一发送
当前可稳定落地的实现方案
方案1:适配改造后的分块强制输出(适合快速实现小量级任务)
这是传统flush方案的改良版,只要适配对应配置就能正常工作,具体操作步骤:
- PHP脚本开头先强制清空所有服务端缓冲:
// 清空所有层级的PHP输出缓冲 while (ob_get_level() > 0) { ob_end_flush(); } // 开启隐式自动刷新 ob_implicit_flush(true); // 关闭zlib压缩,避免压缩逻辑拦截缓冲 ini_set('zlib.output_compression', 0); // 提前释放session锁,避免阻塞其他站点请求 if (session_status() === PHP_SESSION_ACTIVE) { session_write_close(); }
- 循环执行发信逻辑时,每次输出当前收件人信息后,主动填充冗余内容击穿缓冲:
$recipientList = [/* 你的200个收件人数组 */]; foreach ($recipientList as $person) { // 实际发信逻辑 mail_send($person); // 输出当前进度内容 echo "已向:{$person['name']} 发送邮件 <br>"; // 填充2KB冗余内容,强制触发服务器和浏览器把内容推到前端 echo str_repeat(' ', 2048); // 调用PHP的flush方法把内容推到Web服务器 flush(); // 加微小延迟,避免触发服务器的速率限制 usleep(10000); }
- 必须同步修改Web服务器对应路径的配置:给这个发信脚本的访问路径关掉gzip、fastcgi/proxy缓冲,否则内容会被服务器层拦住,哪怕PHP端做了所有冲刷操作也没用。
方案2:异步任务+前端轻量轮询(生产环境优先选的稳定方案)
这个方案完全不依赖缓冲配置,是目前行业通用的长任务进度展示方案,稳定性最高:
- 流程逻辑:
- 用户点击“开始发送”按钮后,PHP不要同步执行发信逻辑,只需要把发信任务的参数、状态(待运行)写入数据库/本地文件/缓存,立刻返回一个进度展示页面
- 独立的执行进程(可以用CLI常驻脚本、或者系统定时任务每10秒扫描一次待运行任务)实际执行发信逻辑,每发送完一个收件人,就把当前进度(已发数量、当前收件人姓名、已完成列表)更新到存储层
- 前端进度页面每1~2秒发一个轻量请求,读取存储层的最新任务进度,把内容实时渲染到页面上,进度达到100%后自动停止轮询
- 这个方案的核心优势:不会长期占用PHP-FPM工作进程,哪怕用户中途关闭页面,发信任务也会在后台完整跑完,不会出现任务中断的问题,也完全不受Web服务器缓冲配置的影响。
方案3:SSE单向推送(低延迟的轻量替代方案)
如果不想用轮询的重复请求,可以用SSE(服务器发送事件)实现更低延迟的实时展示:
- 前端用原生
EventSource接口建立和服务端的长连接,服务端的SSE脚本只负责读取存储层的最新发信进度,有更新就推给前端 - 注意:SSE连接脚本不要承载实际的发信逻辑,核心发信逻辑还是要和方案2一样做异步独立运行,否则长连接会长期占用Web服务器进程。
实操避坑提醒
- 长耗时脚本一定要提前调用
session_write_close()释放session文件锁,否则只要脚本还在运行,所有同域名下的其他用户请求都会被session锁阻塞,直接导致全站卡顿 - 200个收件人的发信量级很小,不需要引入消息队列之类的重型组件,用本地文件或者内存缓存存进度就完全够用
- 不要把发信逻辑直接放在同步Web请求里跑,哪怕能实现实时进度,这种方式一旦用户关闭浏览器,PHP进程就会被中断,发信任务直接半途而废
内容的提问来源于stack exchange,提问作者IanD
相关产品推荐
相关产品推荐

