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默认会开启输出缓冲，需手动清除并防止脚本超时：
@set_time_limit(0); // 取消执行时间限制
ini_set('output_buffering', 'off');
ini_set('zlib.output_compression', false);
flush(); // 每次发送后刷新
完整示例：实时推送时间
创建一个名为sse.php的文件：
<?phpheader('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，就能轻松实现服务端实时推送。适合不需要双向通信的轻量级实时功能。
