SSE通过HTTP实现服务器向浏览器的单向实时推送,适合通知、日志等场景。使用PHP时需设置Content-Type: text/event-stream头,关闭缓存与压缩,禁用输出缓冲并防止超时,通过echo "data: ...\n\n"发送数据并调用flush()强制输出。前端用EventSource接收消息,支持自动重连与自定义事件。示例中每秒推送当前时间,需注意Nginx代理缓冲、函数权限及浏览器兼容性问题。

要实现实时数据从服务器推送到浏览器,SSE(Server-Sent Events)是一种轻量且高效的方式。相比WebSocket,SSE更简单,适合单向推送场景,比如通知、日志流、股票行情等。下面介绍如何使用PHP实现SSE(Server-Sent Events),并确保内容能实时输出。
什么是SSE?
SSE 允许服务器持续向浏览器发送文本数据。它基于HTTP协议,使用text/event-stream MIME类型,保持连接长期打开,直到关闭或出错。
主要特点:
- 服务器单向推送数据到客户端
- 自动重连机制
- 支持事件标识和自定义事件类型
- 基于纯文本传输,兼容性好
PHP实现SSE的基本步骤
要在PHP中启用SSE,需设置正确的响应头,并持续输出符合规范的数据格式。
立即学习“PHP免费学习笔记(深入)”;
1. 设置响应头告诉浏览器当前响应是 event stream 类型:
header('Content-Type: text/event-stream');header('Cache-Control: no-cache');
header('Connection: keep-alive'); 2. 输出SSE格式数据
SSE每条消息以data:开头,用两个换行符\n\n结束:
echo "data: Hello, this is a message\n\n";flush(); // 强制输出缓冲区 3. 防止超时和缓冲
PHP默认会开启输出缓冲,需手动清除并防止脚本超时:
本书是全面讲述PHP与MySQL的经典之作,书中不但全面介绍了两种技术的核心特性,还讲解了如何高效地结合这两种技术构建健壮的数据驱动的应用程序。本书涵盖了两种技术新版本中出现的最新特性,书中大量实际的示例和深入的分析均来自于作者在这方面多年的专业经验,可用于解决开发者在实际中所面临的各种挑战。 本书内容全面深入,适合各层次PHP和MySQL开发人员阅读,既是优秀的学习教程,也可用作参考手册。
ini_set('output_buffering', 'off');
ini_set('zlib.output_compression', false);
flush(); // 每次发送后刷新
完整示例:实时推送时间
创建一个名为sse.php的文件:
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
header('Connection: keep-alive');
@set_time_limit(0);
ini_set('output_buffering', 'off');
ini_set('zlib.output_compression', false);
$count = 0;
while ($count $time = date('Y-m-d H:i:s');
echo "id: " . $count . "\n";
echo "event: server-time\n";
echo "data: Current time is {$time}\n\n";
ob_flush();
flush();
$count++;
sleep(1); // 模拟延迟
}
echo "data: Stream ended.\n\n";
flush();
上面代码每隔1秒推送一次当前时间,共10次。
前端接收SSE消息
使用JavaScript的EventSource对象监听服务端事件:
script>const source = new EventSource('/sse.php');
source.onmessage = function(event) {
console.log('Received:', event.data);
};
source.addEventListener('server-time', function(event) {
document.body.innerHTML += '
' + event.data + '
';});
source.onerror = function() {
console.log('SSE connection closed or error occurred.');
source.close();
};
script>
当页面加载后,会自动连接到sse.php并实时显示推送内容。
注意事项与常见问题
在实际部署中,可能会遇到以下问题:
-
代理或CDN缓存:Nginx、Apache或CDN可能缓冲响应,需配置禁用缓冲。例如Nginx中添加:
proxy_buffering off; - PHP安全模式或函数禁用:某些主机商禁用set_time_limit或flush,需确认权限。
- 浏览器兼容性:现代浏览器基本支持SSE,但IE不支持,可考虑降级方案(如轮询)。
- 内存泄漏风险:长时间运行脚本需注意变量释放和资源清理。
基本上就这些。SSE用起来不复杂,但容易忽略缓冲和超时设置。只要正确配置PHP输出行为,并配合前端EventSource,就能轻松实现服务端实时推送。适合不需要双向通信的轻量级实时功能。










