README

A PHP library for asynchronously serving WebSockets. Build up your application through simple interfaces and re-use your application without changing any of its code just by combining different components.

要求

需要Shell访问权限，建议拥有root权限。为了避免代理/防火墙拦截，建议通过端口80或443（SSL）请求WebSocket，这需要root权限。为了做到这一点，除了您的同步Web栈外，您可以使用反向代理或两台独立的机器。更多详细信息请参阅服务器配置文档。

文档

用户和API文档可在Ratchet网站上找到：http://socketo.me

查看https://github.com/cboden/Ratchet-examples以获取一些使用Ratchet的现成工作演示。

需要帮助？有问题？想要提供反馈？请在Google Groups邮件列表上发消息。

一个快速示例

<?php
use Ratchet\MessageComponentInterface;
use Ratchet\ConnectionInterface;

    // Make sure composer dependencies have been installed
    require __DIR__ . '/vendor/autoload.php';

/**
 * chat.php
 * Send any incoming messages to all connected clients (except sender)
 */
class MyChat implements MessageComponentInterface {
    protected $clients;

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

    public function onOpen(ConnectionInterface $conn) {
        $this->clients->attach($conn);
    }

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

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

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

    // Run the server application through the WebSocket protocol on port 8080
    $app = new Ratchet\App('localhost', 8080);
    $app->route('/chat', new MyChat, array('*'));
    $app->route('/echo', new Ratchet\Server\EchoServer, array('*'));
    $app->run();

$ php chat.php

    // Then some JavaScript in the browser:
    var conn = new WebSocket('ws://:8080/echo');
    conn.onmessage = function(e) { console.log(e.data); };
    conn.onopen = function(e) { conn.send('Hello Me!'); };