README

Ratchet 是一个用于异步服务 WebSocket 的 PHP 库。通过简单的接口构建您的应用程序，并通过组合不同的组件来重用应用程序而无需更改任何代码。

要求

需要 shell 访问，推荐 root 访问。为了避免代理/防火墙阻止，建议在端口 80 或 443（SSL）上请求 WebSocket，这需要 root 访问。为此，您可以使用反向代理或两台独立的机器，与您的同步 Web 栈一起使用。更多详细信息请参阅 服务器配置文档。

文档

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

有关使用 Ratchet 的某些现成工作演示，请参阅 https://github.com/cboden/Ratchet-examples。

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

快速示例

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

use Ratchet\MessageComponentInterface;
use Ratchet\ConnectionInterface;

/**
 * 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://localhost:8080/echo');
conn.onmessage = function(e) { console.log(e.data); };
conn.onopen = function(e) { conn.send('Hello Me!'); };