README

PHP WebSocket 服务器和客户端库。支持最新的 HyBi 规范，以及旧版 Chrome 版本和一些 Flash 回退解决方案使用的 Hixie #76 规范。

该项目启动的目的是为http://www.u2start.com/ 带来更多交互功能。

功能

服务器

Hixie #76 和 Hybi #12 协议版本
Flash 客户端支持（也在同一端口上提供 XML 政策文件）
- 有关兼容 Flash 客户端的详细信息，请参阅https://github.com/gimite/web-socket-js
原生 Firefox、Safari（iPod / iPhone 也一样）、Chrome 和 IE10 支持。使用 Flash 客户端，支持 Flash 的所有浏览器都可以正常工作（包括 IE6-9、Opera、Android 和其他旧版桌面浏览器）。
Opera（移动版）原生支持 WebSocket，但默认情况下已禁用支持。可以在 opera:config 中启用。

客户端

支持 Hybi / Hixie76
基于事件异步 I/O

入门指南

最简单的方法是将 PHPWS 作为 Composer 依赖项使用。将以下内容添加到您的 composer.json 文件中

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/Devristo/phpws"
        }
    ],
    "require": {
        "devristo/phpws": "dev-master"
    }
}

然后运行 php composer.phar install

为了验证它是否正常工作，在您的项目根目录中创建一个 time.php 文件

require_once("vendor/autoload.php");
use Devristo\Phpws\Server\WebSocketServer;

$loop = \React\EventLoop\Factory::create();

// Create a logger which writes everything to the STDOUT
$logger = new \Zend\Log\Logger();
$writer = new Zend\Log\Writer\Stream("php://output");
$logger->addWriter($writer);

// Create a WebSocket server using SSL
$server = new WebSocketServer("tcp://0.0.0.0:12345", $loop, $logger);

$loop->addPeriodicTimer(0.5, function() use($server, $logger){
    $time = new DateTime();
    $string = $time->format("Y-m-d H:i:s");
    $logger->notice("Broadcasting time to all clients: $string");
    foreach($server->getConnections() as $client)
        $client->sendString($string);
});


// Bind the server
$server->bind();

// Start the event loop
$loop->run();

并创建一个客户端 time.html 文件，如下所示

<html>
    <head>
        <title>WebSocket TEST</title>
    </head>
    <body>
        <h1>Server Time</h1>
        <strong id="time"></strong>

        <script>
            var socket = new WebSocket("ws://localhost:12345/");
            socket.onmessage = function(msg) {
                document.getElementById("time").innerText = msg.data;
            };
        </script>
    </body>
</html>

现在从命令行运行 time.php，并在浏览器中打开 time.html。您应该看到由 phpws 定期广播的当前时间。如果这可行，您可能对示例文件夹中的更复杂的服务器感兴趣。

使用 Phpws 客户端入门

以下是一个托管在http://echo.websocket.org 的 WebSocket 服务器客户端。

require_once("vendor/autoload.php");                // Composer autoloader

$loop = \React\EventLoop\Factory::create();

$logger = new \Zend\Log\Logger();
$writer = new Zend\Log\Writer\Stream("php://output");
$logger->addWriter($writer);

$client = new \Devristo\Phpws\Client\WebSocket("ws://echo.websocket.org/?encoding=text", $loop, $logger);

$client->on("request", function($headers) use ($logger){
    $logger->notice("Request object created!");
});

$client->on("handshake", function() use ($logger) {
    $logger->notice("Handshake received!");
});

$client->on("connect", function($headers) use ($logger, $client){
    $logger->notice("Connected!");
    $client->send("Hello world!");
});

$client->on("message", function($message) use ($client, $logger){
    $logger->notice("Got message: ".$message->getData());
    $client->close();
});

$client->open();
$loop->run();

已知问题

缺少 ORIGIN 检查（可以在 onConnect 中使用 getHeaders() 手动实现，当您不喜欢 Origin 标头时断开用户连接）
不支持 HyBi 规范中的扩展数据。

要求

服务器

PHP 5.4
服务器开放端口
PHP OpenSSL 模块以在加密连接上运行服务器
http://pecl.php.net/package/pecl_http，因为它是 Zend\Uri 的依赖项
Composer 依赖项 * 当使用 phpws 作为 composer 包时，这些将自动安装。
Reactphp
ZF2 Logger

客户端

PHP 5.4
实现 HyBi (#8-#12) 草案版本的服务器
PHP OpenSSL 模块以使用 SSL 连接（wss:// uris）

mpociot / phpws

维护者

详细信息

README

功能

入门指南

使用 Phpws 客户端入门

已知问题

要求