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 — резкий рост числа клиентов без соответствующего роста трафика на сайте обычно означает, что старые соединения не закрываются корректно и копятся, постепенно исчерпывая память процесса.