Stubs, coverage, api docs

lib/Ratchet/ApplicationInterface.php

@@ -0,0 +1,5 @@
+<?php
+namespace Ratchet;
+
+interface ApplicationInterface {
+}

lib/Ratchet/Protocol/ProtocolInterface.php

@@ -3,4 +3,8 @@ namespace Ratchet\Protocol;
 use Ratchet\ServerInterface;
 
 interface ProtocolInterface extends ServerInterface {
+    /**
+     * @return Array
+     */
+    static function getDefaultConfig();
 }

lib/Ratchet/Protocol/WebSocket/ApplicationInterface.php

@@ -0,0 +1,6 @@
+<?php
+namespace Ratchet\Protocol\WebSocket;
+use Ratchet\ApplicationInterface as AI;
+
+class ApplicationInterface extends AI {
+}

lib/Ratchet/Protocol/WebSocket/Server.php

@@ -10,6 +10,20 @@ class Server implements ProtocolInterface {
         $this->_server = $server;
     }
 
+    /**
+     * @return Array
+     */
+    public static function getDefaultConfig() {
+        return Array(
+            'domain'   => AF_INET
+          , 'type'     => SOCK_STREAM
+          , 'protocol' => SOL_TCP
+          , 'options'  => Array(
+                SOL_SOCKET => Array(SO_REUSEADDR => 1)
+            )
+        );
+    }
+
     public function run() {
     }
 }

lib/Ratchet/Server.php

@@ -10,5 +10,9 @@ class Server implements ServerInterface {
     }
 
     public function run() {
+        set_time_limit(0);
+        ob_implicit_flush();
+//        $this->_master->set_nonblock();
+//        declare(ticks = 1); 
     }
 }

lib/Ratchet/Socket.php

@@ -1,7 +1,14 @@
 <?php
 namespace Ratchet;
 
+/**
+ * A wrapper for the PHP socket_ functions
+ * @author Chris Boden <shout at chrisboden dot ca>
+ */
 class Socket {
+    /**
+     * @type resource
+     */
     protected $_socket;
 
     public static $_defaults = Array(
@@ -10,11 +17,23 @@ class Socket {
       , 'protocol' => SOL_TCP
     );
 
+    /**
+     * @param int Specifies the protocol family to be used by the socket.
+     * @param int The type of communication to be used by the socket
+     * @param int Sets the specific protocol within the specified domain to be used when communicating on the returned socket
+     * @throws Ratchet\Exception
+     */
     public function __construct($domain = null, $type = null, $protocol = null) {
         list($domain, $type, $protocol) = static::getConfig($domain, $type, $protocol);
-        $this->_socket = socket_create($domain, $type, $protocol);
+
+        if (false === ($this->_socket = socket_create($domain, $type, $protocol))) {
+            throw new Exception();
+        }
     }
 
+    /**
+     * @internal
+     */
     protected static function getConfig($domain = null, $type = null, $protocol = null) {
         foreach (static::$_defaults as $key => $val) {
             if (null === $$key) {
@@ -25,6 +44,9 @@ class Socket {
         return Array($domain, $type, $protocol);
     }
 
+    /**
+     * @internal
+     */
     public function __call($method, $arguments) {
         if (function_exists('socket_' . $method)) {
             array_unshift($arguments, $this->_socket);

phpunit.xml.dist

@@ -7,6 +7,7 @@
     backupGlobals="false"
     backupStaticAttributes="false"
     syntaxCheck="false"
+    stopOnError="false"
 >
 
     <testsuites>
@@ -14,4 +15,10 @@
             <directory>./tests/Ratchet/</directory>
         </testsuite>
     </testsuites>
+
+    <filter>
+        <blacklist>
+            <directory>./tests/</directory>
+        </blacklist>
+    </filter>
 </phpunit>