SSE

Este recurso requer workerman>=4.0.0

SSE, ou Server-sent Events, é uma tecnologia de push do servidor. Sua essência é que, após o cliente enviar uma solicitação http com o cabeçalho Accept: text/event-stream, a conexão não é fechada, permitindo que o servidor envie continuamente dados ao cliente por meio dessa conexão.

As diferenças em relação ao websocket são:

  • SSE permite apenas que o servidor envie para o cliente; Websocket pode ser bidirecional.
  • SSE oferece suporte automático à reconexão; WebSocket precisa ser implementado manualmente.
  • SSE só pode transmitir texto em utf8, dados binários precisam ser codificados em utf8 antes de serem enviados; WebSocket suporta o envio de dados em utf8 e binários por padrão.
  • SSE possui tipos de mensagem embutidos; WebSocket precisa ser implementado manualmente.

Exemplo

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)
{
    // Se o cabeçalho Accept for text/event-stream, significa que é um pedido SSE
    if ($request->header('accept') === 'text/event-stream') {
        // Primeiro, envie uma resposta com o cabeçalho Content-Type: text/event-stream
        $connection->send(new Response(200, ['Content-Type' => 'text/event-stream'], "\r\n"));
        // Envie dados ao cliente em intervalos regulares
        $timer_id = Timer::add(2, function () use ($connection, &$timer_id){
            // É necessário remover o temporizador quando a conexão for fechada para evitar vazamentos de memória
            if ($connection->getStatus() !== TcpConnection::STATUS_ESTABLISHED) {
                Timer::del($timer_id);
                return;
            }
            // Envia um evento message, com os dados como hello; o ID da mensagem pode ser omitido
            $connection->send(new ServerSentEvents(['event' => 'message', 'data' => 'hello', 'id'=>1]));
        });
        return;
    }
    $connection->send('ok');
};

// Executa o worker
Worker::runAll();

Código JavaScript do cliente

var source = new EventSource('http://127.0.0.1:8080');
source.addEventListener('message', function (event) {
  var data = event.data;
  console.log(data); // Exibe hello
}, false);