SSE
此特性需要 workerman >= 4.0.0
SSE 也就是 Server-sent Events,是一種服務端推送技術。它的本質是客戶端發送一個攜帶 Accept: text/event-stream 標頭的 http 請求後,連接不關閉,服務端可以在這個連接上不斷的給客戶端推送數據。
它與 websocket 的區別是:
- SSE 只能服務端向客戶端推;Websocket 可以雙向通信。
- SSE 預設支持斷線重連;WebSocket 需要自己實現。
- SSE 只能傳輸 utf8 文本,二進制數據需要編碼成 utf8 後傳送;WebSocket 預設支持傳送 utf8 和二進制數據。
- SSE 自帶消息類型;WebSocket 需要自己實現。
例子
use Workerman\Worker;
use Workerman\Connection\TcpConnection;
use Workerman\Protocols\Http\Request;
use Workerman\Protocols\Http\ServerSentEvents;
use Workerman\Protocols\Http\Response;
use Workerman\Timer;
require_once __DIR__ . '/vendor/autoload.php';
$worker = new Worker('http://0.0.0.0:8080');
$worker->onMessage = function(TcpConnection $connection, Request $request)
{
// 如果 Accept 標頭是 text/event-stream 則說明是 SSE 請求
if ($request->header('accept') === 'text/event-stream') {
// 首先發送一個 Content-Type: text/event-stream 標頭的響應
$connection->send(new Response(200, ['Content-Type' => 'text/event-stream'], "\r\n"));
// 定時向客戶端推送數據
$timer_id = Timer::add(2, function () use ($connection, &$timer_id){
// 連接關閉的時候要將定時器刪除,避免定時器不斷累積導致內存泄漏
if ($connection->getStatus() !== TcpConnection::STATUS_ESTABLISHED) {
Timer::del($timer_id);
return;
}
// 發送 message 事件,事件攜帶的數據為 hello,消息 id 可以不傳
$connection->send(new ServerSentEvents(['event' => 'message', 'data' => 'hello', 'id'=>1]));
});
return;
}
$connection->send('ok');
};
// 運行 worker
Worker::runAll();
客戶端 javascript 代碼
var source = new EventSource('http://127.0.0.1:8080');
source.addEventListener('message', function (event) {
var data = event.data;
console.log(data); // 輸出 hello
}, false);