SSE

هذه الميزة تتطلب workerman>=4.0.0

SSE أو Server-sent Events، هي تقنية دفع خادم. جوهرها أن العميل يرسل طلب http يحمل رأس Accept: text/event-stream ثم لا يتم إغلاق الاتصال، ويمكن للخادم أن يستمر في إرسال البيانات للعميل على هذا الاتصال.

الفروق بينها وبين 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، ويمكن عدم إرسال معرف الرسالة
            $connection->send(new ServerSentEvents(['event' => 'message', 'data' => 'hello', 'id'=>1]));
        });
        return;
    }
    $connection->send('ok');
};

// تشغيل العامل
Worker::runAll();

كود جافاسكريبت للعميل

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