WebSockets на PHP з Ratchet

WebSockets дають змогу створювати двосторонні з'єднання між сервером і браузером без постійних HTTP-запитів. Ratchet — популярна PHP-бібліотека поверх ReactPHP для побудови WebSocket-серверів.

Встановлення Ratchet

composer require cboden/ratchet

Простий WebSocket-сервер

<?php
require 'vendor/autoload.php';

use Ratchet\MessageComponentInterface;
use Ratchet\ConnectionInterface;
use Ratchet\Server\IoServer;
use Ratchet\Http\HttpServer;
use Ratchet\WebSocket\WsServer;

class Chat implements MessageComponentInterface {
    protected $clients;

    public function __construct() {
        $this->clients = new \SplObjectStorage;
    }

    public function onOpen(ConnectionInterface $conn) {
        $this->clients->attach($conn);
        echo "New connection: {$conn->resourceId}\n";
    }

    public function onMessage(ConnectionInterface $from, $msg) {
        foreach ($this->clients as $client) {
            if ($client !== $from) {
                $client->send($msg);
            }
        }
    }

    public function onClose(ConnectionInterface $conn) {
        $this->clients->detach($conn);
    }

    public function onError(ConnectionInterface $conn, \Exception $e) {
        $conn->close();
    }
}

$server = IoServer::factory(
    new HttpServer(new WsServer(new Chat())),
    8080
);
$server->run();

Клієнтський JavaScript

const ws = new WebSocket('wss://yourdomain.com/ws');

ws.onopen = () => console.log('Connected');
ws.onmessage = (e) => console.log('Message:', e.data);

// Отправка сообщения
ws.send(JSON.stringify({ user: 'Alice', text: 'Hello!' }));

Nginx Reverse Proxy для WebSockets

server {
    listen 443 ssl;
    server_name yourdomain.com;

    location /ws {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 86400;
    }
}

Автозапуск через systemd

[Unit]
Description=Ratchet WebSocket Server
After=network.target

[Service]
Type=simple
User=www-data
ExecStart=/usr/bin/php /var/www/html/ws-server.php
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

systemctl enable ratchet-ws
systemctl start ratchet-ws
systemctl status ratchet-ws

Альтернатива: Для високонавантажених систем розгляньте Swoole або ReactPHP напряму — вони продуктивніші за Ratchet і підтримують корутини.

Реальні помилки WebSocket-сервера

Порт уже зайнятий

PHP Fatal error:  Uncaught React\\Socket\\ConnectionException: Could not bind to tcp://0.0.0.0:8080: Address already in use in /var/www/html/vendor/react/socket/src/TcpServer.php:54

Попередній процес сервера не завершився коректно (завис після збою або був запущений вручну й забутий) і продовжує утримувати порт. Перевіряйте зайнятість порту перед стартом, а не лише покладайтеся на systemd.

Помилка WebSocket handshake у браузері

WebSocket connection to 'wss://yourdomain.com/ws' failed: Error during WebSocket handshake: Unexpected response code: 502

502 на етапі handshake майже завжди означає, що Nginx не зміг достукатися до PHP-процесу Ratchet: або сервер не запущений, або в proxy_pass вказано неправильний порт. Код 400 на цьому самому етапі зазвичай говорить про відсутність заголовків Upgrade і Connection у конфігу reverse proxy.

Коли Ratchet не підходить

Однопотоковий event loop: один синхронний виклик — повільний SQL-запит чи file_get_contents() до зовнішнього API — блокує обробку взагалі всіх підключених клієнтів, доки не завершиться.
Немає вбудованої кластеризації: щоб розподілити навантаження на кілька серверів, потрібен зовнішній брокер повідомлень (Redis Pub/Sub) і sticky-сесії на балансувальнику — сам Ratchet цим не займається.
CPU-важка обробка кожного повідомлення (шифрування, генерація зображень) не підходить для однопотокової моделі — таку роботу варто виносити в окремі воркери через чергу, наприклад на Swoole, де є вбудовані корутини.

Перевірка результату

# Порт прослуховується процесом сервера
ss -tlnp | grep 8080

# Ручна перевірка handshake без браузера
curl -i -N \
  -H "Connection: Upgrade" \
  -H "Upgrade: websocket" \
  -H "Sec-WebSocket-Version: 13" \
  -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" \
  http://127.0.0.1:8080/

# Статус systemd-юніту та останні рядки логу
systemctl status ratchet-ws --no-pager
journalctl -u ratchet-ws -n 50

Успішна відповідь на ручний curl-запит — статус 101 Switching Protocols. Будь-який інший код означає проблему ще до того, як запрацює сам чат: перевіряйте її окремо від логіки Ratchet.

Корисно логувати кількість активних підключень усередині onOpen і onClose — різке зростання кількості клієнтів без відповідного зростання трафіку на сайті зазвичай означає, що старі з'єднання не закриваються коректно і накопичуються, поступово вичерпуючи пам'ять процесу.