Go to file
2013-06-01 20:25:31 -04:00
src/Ratchet Version bump 2013-06-01 20:25:31 -04:00
tests Minor doc corrections 2013-04-13 10:55:28 -04:00
.gitignore Makefile 2012-07-12 14:26:32 -04:00
.travis.yml Travis download deps from GitHub source 2013-01-05 16:41:42 -05:00
CHANGELOG.md Version bump 2013-06-01 20:25:31 -04:00
composer.json Fixing more Guzzle API breaks 2013-06-01 20:24:11 -04:00
composer.lock Fixing more Guzzle API breaks 2013-06-01 20:24:11 -04:00
LICENSE Version bump 2013-03-09 09:06:25 -05:00
Makefile AB testing 2013-03-29 20:01:24 -04:00
phpunit.xml.dist Guzzle changes 2012-05-08 12:46:21 -04:00
README.md Updated readme with docs conf link and browser info 2013-05-01 08:08:51 -04:00

#Ratchet

Build Status

A PHP 5.3 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.

##WebSocket Compliance

  • Supports the RFC6455, HyBi-10+, and Hixie76 protocol versions (at the same time)
  • Tested on Chrome 13 - 26, Firefox 6 - 20, Safari 5.0.1 - 6, iOS 4.2 - 6
  • Ratchet passes the Autobahn Testsuite (non-binary messages)

##Requirements

Shell access is required and root access is recommended. To avoid proxy/firewall blockage it's recommended WebSockets are requested on port 80, which requires root access. In order to do this, along with your sync web stack, you can either use a reverse proxy or two separate machines. You can find more details in the server conf docs.

PHP 5.3.3 (or higher) is required. If you have access, PHP 5.4 is highly recommended for its performance improvements.

Documentation

User and API documentation is available on Ratchet's website: http://socketo.me

See https://github.com/cboden/Ratchet-examples for some out-of-the-box working demos using Ratchet.

Need help? Have a question? Want to provide feedback? Write a message on the Google Groups Mailing List.


###A quick server example

<?php
use Ratchet\MessageComponentInterface;
use Ratchet\ConnectionInterface;
use Ratchet\Server\IoServer;
use Ratchet\WebSocket\WsServer;

    require __DIR__ . '/vendor/autoload.php';

/**
 * chat.php
 * Send any incoming messages to all connected clients (except sender)
 */
class Chat 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
    $server = IoServer::factory(new WsServer(new Chat), 8080);
    $server->run();
$ php chat.php