shahradelahi / easy-http

src/Middleware.php

Indentation +187 added lines, -187 removed lines

@@ -17,192 +17,192 @@
 class Middleware
 {
 
-	/**
-	 * Create curl handler.
-	 *
-	 * @param ?string $method
-	 * @param string $uri
-	 * @param array|HttpOptions $options
-	 *
-	 * @return \CurlHandle|false
-	 */
-	public static function create_curl_handler(?string $method, string $uri, array|HttpOptions $options = []): \CurlHandle|false
-	{
-		$handler = curl_init();
-		if (is_resource($handler) || !$handler) {
-			return false;
-		}
-
-		if (gettype($options) === 'array') {
-			$options = new HttpOptions($options);
-		}
-
-		if (count($options->getQuery()) > 0) {
-			if (!str_contains($uri, '?')) {
-				$uri .= '?';
-			}
-			$uri .= $options->getQueryString();
-		}
-
-		curl_setopt($handler, CURLOPT_URL, $uri);
-
-		self::set_curl_options($method, $handler, $options);
-
-		return $handler;
-	}
-
-	/**
-	 * Setup curl options based on the given method and our options.
-	 *
-	 * @param \CurlHandle $cHandler
-	 * @param ?string $method
-	 * @param HttpOptions $options
-	 *
-	 * @return void
-	 */
-	public static function set_curl_options(?string $method, \CurlHandle $cHandler, HttpOptions $options): void
-	{
-		curl_setopt($cHandler, CURLOPT_HEADER, true);
-		curl_setopt($cHandler, CURLOPT_CUSTOMREQUEST, $method ?? 'GET');
-
-		# Fetch the header
-		$fetchedHeaders = [];
-		foreach ($options->getHeaders() as $header => $value) {
-			$fetchedHeaders[] = $header . ': ' . $value;
-		}
-
-		# Set headers
-		curl_setopt($cHandler, CURLOPT_HTTPHEADER, $fetchedHeaders ?? []);
-
-		# Add body if we have one.
-		if ($options->getBody()) {
-			curl_setopt($cHandler, CURLOPT_CUSTOMREQUEST, $method ?? 'POST');
-			curl_setopt($cHandler, CURLOPT_POSTFIELDS, $options->getBody());
-			curl_setopt($cHandler, CURLOPT_POST, true);
-		}
-
-		# Check for a proxy
-		if ($options->getProxy() != null) {
-			curl_setopt($cHandler, CURLOPT_PROXY, $options->getProxy()->getHost());
-			curl_setopt($cHandler, CURLOPT_PROXYUSERPWD, $options->getProxy()->getAuth());
-			if ($options->getProxy()->type !== null) {
-				curl_setopt($cHandler, CURLOPT_PROXYTYPE, $options->getProxy()->type);
-			}
-		}
-
-		curl_setopt($cHandler, CURLOPT_RETURNTRANSFER, true);
-		curl_setopt($cHandler, CURLOPT_FOLLOWLOCATION, true);
-
-		# Add and override the custom curl options.
-		foreach ($options->getCurlOptions() as $option => $value) {
-			curl_setopt($cHandler, $option, $value);
-		}
-
-		# if we have a timeout, set it.
-		curl_setopt($cHandler, CURLOPT_TIMEOUT, $options->getTimeout());
-
-		# If self-signed certs are allowed, set it.
-		if ((bool)getenv('HAS_SELF_SIGNED_CERT') === true) {
-			curl_setopt($cHandler, CURLOPT_SSL_VERIFYPEER, false);
-			curl_setopt($cHandler, CURLOPT_SSL_VERIFYHOST, false);
-		}
-
-		(new Middleware())->handle_media($cHandler, $options);
-	}
-
-	/**
-	 * Handle the media
-	 *
-	 * @param \CurlHandle $handler
-	 * @param HttpOptions $options
-	 * @return void
-	 */
-	private function handle_media(\CurlHandle $handler, HttpOptions $options): void
-	{
-		if (count($options->getMultipart()) > 0) {
-			curl_setopt($handler, CURLOPT_POST, true);
-			curl_setopt($handler, CURLOPT_CUSTOMREQUEST, 'POST');
-
-			$form_data = new FormData();
-			foreach ($options->getMultipart() as $key => $value) {
-				$form_data->addFile($key, $value);
-			}
-
-			$headers = [];
-			foreach ($options->getHeaders() as $header => $value) {
-				if (Toolkit::insensitiveString($header, 'content-type')) continue;
-				$headers[] = $header . ': ' . $value;
-			}
-			$headers[] = 'Content-Type: multipart/form-data';
-
-			curl_setopt($handler, CURLOPT_HTTPHEADER, $headers);
-			curl_setopt($handler, CURLOPT_POSTFIELDS, $form_data->getFiles());
-		}
-	}
-
-	/**
-	 * @param mixed $socket
-	 * @param int $len
-	 * @return string|null
-	 * @throws ConnectionException
-	 */
-	public static function stream_read(mixed $socket, int $len): string|null
-	{
-		if (!is_resource($socket)) {
-			throw new ConnectionException(sprintf(
-				'%s is not a valid resource. Datatype: %s', $socket, gettype($socket)
-			));
-		}
-
-		$data = '';
-		while (($dataLen = strlen($data)) < $len) {
-			$buff = fread($socket, $len - $dataLen);
-
-			if ($buff === false) {
-				return null;
-			}
-
-			if ($buff === '') {
-				$metadata = stream_get_meta_data($socket);
-				throw new ConnectionException(
-					sprintf('Empty read; connection dead?  Stream state: %s', json_encode($metadata)),
-					CommonsContract::CLIENT_EMPTY_READ
-				);
-			}
-			$data .= $buff;
-		}
-
-		return $data;
-	}
-
-	/**
-	 * @param mixed $socket
-	 * @param string $data
-	 * @return bool
-	 * @throws ConnectionException
-	 */
-	public static function stream_write(mixed $socket, string $data): bool
-	{
-		if (!is_resource($socket)) {
-			throw new ConnectionException(sprintf(
-				'%s is not a valid resource. Datatype: %s', $socket, gettype($socket)
-			));
-		}
-
-		$written = fwrite($socket, $data);
-
-		if ($written < strlen($data)) {
-			throw new ConnectionException(
-				sprintf('Could only write %s out of %s bytes.', $written, strlen($data)),
-				CommonsContract::CLIENT_COULD_ONLY_WRITE_LESS
-			);
-		}
-
-		return true;
-	}
-
-	/**
-	 * Stream connect
-	 */
+    /**
+     * Create curl handler.
+     *
+     * @param ?string $method
+     * @param string $uri
+     * @param array|HttpOptions $options
+     *
+     * @return \CurlHandle|false
+     */
+    public static function create_curl_handler(?string $method, string $uri, array|HttpOptions $options = []): \CurlHandle|false
+    {
+        $handler = curl_init();
+        if (is_resource($handler) || !$handler) {
+            return false;
+        }
+
+        if (gettype($options) === 'array') {
+            $options = new HttpOptions($options);
+        }
+
+        if (count($options->getQuery()) > 0) {
+            if (!str_contains($uri, '?')) {
+                $uri .= '?';
+            }
+            $uri .= $options->getQueryString();
+        }
+
+        curl_setopt($handler, CURLOPT_URL, $uri);
+
+        self::set_curl_options($method, $handler, $options);
+
+        return $handler;
+    }
+
+    /**
+     * Setup curl options based on the given method and our options.
+     *
+     * @param \CurlHandle $cHandler
+     * @param ?string $method
+     * @param HttpOptions $options
+     *
+     * @return void
+     */
+    public static function set_curl_options(?string $method, \CurlHandle $cHandler, HttpOptions $options): void
+    {
+        curl_setopt($cHandler, CURLOPT_HEADER, true);
+        curl_setopt($cHandler, CURLOPT_CUSTOMREQUEST, $method ?? 'GET');
+
+        # Fetch the header
+        $fetchedHeaders = [];
+        foreach ($options->getHeaders() as $header => $value) {
+            $fetchedHeaders[] = $header . ': ' . $value;
+        }
+
+        # Set headers
+        curl_setopt($cHandler, CURLOPT_HTTPHEADER, $fetchedHeaders ?? []);
+
+        # Add body if we have one.
+        if ($options->getBody()) {
+            curl_setopt($cHandler, CURLOPT_CUSTOMREQUEST, $method ?? 'POST');
+            curl_setopt($cHandler, CURLOPT_POSTFIELDS, $options->getBody());
+            curl_setopt($cHandler, CURLOPT_POST, true);
+        }
+
+        # Check for a proxy
+        if ($options->getProxy() != null) {
+            curl_setopt($cHandler, CURLOPT_PROXY, $options->getProxy()->getHost());
+            curl_setopt($cHandler, CURLOPT_PROXYUSERPWD, $options->getProxy()->getAuth());
+            if ($options->getProxy()->type !== null) {
+                curl_setopt($cHandler, CURLOPT_PROXYTYPE, $options->getProxy()->type);
+            }
+        }
+
+        curl_setopt($cHandler, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($cHandler, CURLOPT_FOLLOWLOCATION, true);
+
+        # Add and override the custom curl options.
+        foreach ($options->getCurlOptions() as $option => $value) {
+            curl_setopt($cHandler, $option, $value);
+        }
+
+        # if we have a timeout, set it.
+        curl_setopt($cHandler, CURLOPT_TIMEOUT, $options->getTimeout());
+
+        # If self-signed certs are allowed, set it.
+        if ((bool)getenv('HAS_SELF_SIGNED_CERT') === true) {
+            curl_setopt($cHandler, CURLOPT_SSL_VERIFYPEER, false);
+            curl_setopt($cHandler, CURLOPT_SSL_VERIFYHOST, false);
+        }
+
+        (new Middleware())->handle_media($cHandler, $options);
+    }
+
+    /**
+     * Handle the media
+     *
+     * @param \CurlHandle $handler
+     * @param HttpOptions $options
+     * @return void
+     */
+    private function handle_media(\CurlHandle $handler, HttpOptions $options): void
+    {
+        if (count($options->getMultipart()) > 0) {
+            curl_setopt($handler, CURLOPT_POST, true);
+            curl_setopt($handler, CURLOPT_CUSTOMREQUEST, 'POST');
+
+            $form_data = new FormData();
+            foreach ($options->getMultipart() as $key => $value) {
+                $form_data->addFile($key, $value);
+            }
+
+            $headers = [];
+            foreach ($options->getHeaders() as $header => $value) {
+                if (Toolkit::insensitiveString($header, 'content-type')) continue;
+                $headers[] = $header . ': ' . $value;
+            }
+            $headers[] = 'Content-Type: multipart/form-data';
+
+            curl_setopt($handler, CURLOPT_HTTPHEADER, $headers);
+            curl_setopt($handler, CURLOPT_POSTFIELDS, $form_data->getFiles());
+        }
+    }
+
+    /**
+     * @param mixed $socket
+     * @param int $len
+     * @return string|null
+     * @throws ConnectionException
+     */
+    public static function stream_read(mixed $socket, int $len): string|null
+    {
+        if (!is_resource($socket)) {
+            throw new ConnectionException(sprintf(
+                '%s is not a valid resource. Datatype: %s', $socket, gettype($socket)
+            ));
+        }
+
+        $data = '';
+        while (($dataLen = strlen($data)) < $len) {
+            $buff = fread($socket, $len - $dataLen);
+
+            if ($buff === false) {
+                return null;
+            }
+
+            if ($buff === '') {
+                $metadata = stream_get_meta_data($socket);
+                throw new ConnectionException(
+                    sprintf('Empty read; connection dead?  Stream state: %s', json_encode($metadata)),
+                    CommonsContract::CLIENT_EMPTY_READ
+                );
+            }
+            $data .= $buff;
+        }
+
+        return $data;
+    }
+
+    /**
+     * @param mixed $socket
+     * @param string $data
+     * @return bool
+     * @throws ConnectionException
+     */
+    public static function stream_write(mixed $socket, string $data): bool
+    {
+        if (!is_resource($socket)) {
+            throw new ConnectionException(sprintf(
+                '%s is not a valid resource. Datatype: %s', $socket, gettype($socket)
+            ));
+        }
+
+        $written = fwrite($socket, $data);
+
+        if ($written < strlen($data)) {
+            throw new ConnectionException(
+                sprintf('Could only write %s out of %s bytes.', $written, strlen($data)),
+                CommonsContract::CLIENT_COULD_ONLY_WRITE_LESS
+            );
+        }
+
+        return true;
+    }
+
+    /**
+     * Stream connect
+     */
 
 }
\ No newline at end of file

src/Traits/WSClientTrait.php

Indentation +266 added lines, -266 removed lines

@@ -19,271 +19,271 @@
 trait WSClientTrait
 {
 
-	/**
-	 * Validates whether server sent valid upgrade response
-	 *
-	 * @param WebSocketConfig $config
-	 * @param string $pathWithQuery
-	 * @param string $key
-	 * @throws ConnectionException
-	 */
-	private function validateResponse(WebSocketConfig $config, string $pathWithQuery, string $key): void
-	{
-		$response = stream_get_line($this->socket, self::DEFAULT_RESPONSE_HEADER, "\r\n\r\n");
-		if (!preg_match(self::SEC_WEBSOCKET_ACCEPT_PTTRN, $response, $matches)) {
-			$address = $config->getScheme() . '://' . $config->getHost() . ':' . $config->getPort() . $pathWithQuery;
-			throw new ConnectionException(
-				"Connection to '{$address}' failed: Server sent invalid upgrade response:\n"
-				. $response, CommonsContract::CLIENT_INVALID_UPGRADE_RESPONSE
-			);
-		}
-
-		$keyAccept = trim($matches[1]);
-		$expectedResponse = base64_encode(pack('H*', sha1($key . self::SERVER_KEY_ACCEPT)));
-		if ($keyAccept !== $expectedResponse) {
-			throw new ConnectionException(
-				'Server sent bad upgrade response.',
-				CommonsContract::CLIENT_INVALID_UPGRADE_RESPONSE
-			);
-		}
-	}
-
-	/**
-	 *  Gets host uri based on protocol
-	 *
-	 * @param WebSocketConfig $config
-	 * @return string
-	 * @throws BadUriException
-	 */
-	private function getHostUri(WebSocketConfig $config): string
-	{
-		if (in_array($config->getScheme(), ['ws', 'wss'], true) === false) {
-			throw new BadUriException(
-				"Url should have scheme ws or wss, not '{$config->getScheme()}' from URI '$this->socketUrl' .",
-				CommonsContract::CLIENT_INCORRECT_SCHEME
-			);
-		}
-
-		return ($config->getScheme() === 'wss' ? 'ssl' : 'tcp') . '://' . $config->getHost();
-	}
-
-	/**
-	 * @param string $data
-	 * @return float|int
-	 * @throws ConnectionException
-	 */
-	private function getPayloadLength(string $data): float|int
-	{
-		$payloadLength = (int)ord($data[1]) & self::MASK_127; // Bits 1-7 in byte 1
-		if ($payloadLength > self::MASK_125) {
-			if ($payloadLength === self::MASK_126) {
-				$data = $this->read(2); // 126: Payload is a 16-bit unsigned int
-			} else {
-				$data = $this->read(8); // 127: Payload is a 64-bit unsigned int
-			}
-			$payloadLength = bindec(Toolkit::sprintB($data));
-		}
-
-		return $payloadLength;
-	}
-
-	/**
-	 * @param string $data
-	 * @param int $payloadLength
-	 * @return string
-	 * @throws ConnectionException
-	 */
-	private function getPayloadData(string $data, int $payloadLength): string
-	{
-		// Masking?
-		$mask = (bool)(ord($data[1]) >> 7);  // Bit 0 in byte 1
-		$payload = '';
-		$maskingKey = '';
-
-		// Get masking key.
-		if ($mask) {
-			$maskingKey = $this->read(4);
-		}
-
-		// Get the actual payload, if any (might not be for e.g. close frames.
-		if ($payloadLength > 0) {
-			$data = $this->read($payloadLength);
-
-			if ($mask) {
-				// Unmask payload.
-				for ($i = 0; $i < $payloadLength; $i++) {
-					$payload .= ($data[$i] ^ $maskingKey[$i % 4]);
-				}
-			} else {
-				$payload = $data;
-			}
-		}
-
-		return $payload;
-	}
-
-	/**
-	 * @return string|null
-	 * @throws \Exception
-	 */
-	protected function receiveFragment(): string|null
-	{
-		$data = $this->read(2);
-		if (is_string($data) === false) {
-			return null;
-		}
-
-		$final = (bool)(ord($data[0]) & 1 << 7);
-
-		$opcodeInt = ord($data[0]) & 31;
-		$opcodeInts = array_flip(self::$opcodes);
-		if (!array_key_exists($opcodeInt, $opcodeInts)) {
-			throw new ConnectionException(
-				"Bad opcode in websocket frame: $opcodeInt",
-				CommonsContract::CLIENT_BAD_OPCODE
-			);
-		}
-
-		$opcode = $opcodeInts[$opcodeInt];
-
-		if ($opcode !== 'continuation') {
-			$this->lastOpcode = $opcode;
-		}
-
-		$payloadLength = $this->getPayloadLength($data);
-		$payload = $this->getPayloadData($data, $payloadLength);
-
-		if ($opcode === CommonsContract::EVENT_TYPE_CLOSE) {
-			if ($payloadLength >= 2) {
-				$statusBin = $payload[0] . $payload[1];
-				$status = bindec(sprintf('%08b%08b', ord($payload[0]), ord($payload[1])));
-				$this->closeStatus = $status;
-				$payload = substr($payload, 2);
-
-				if (!$this->isClosing) {
-					$this->send($statusBin . 'Close acknowledged: ' . $status,
-						CommonsContract::EVENT_TYPE_CLOSE); // Respond.
-				}
-			}
-
-			if ($this->isClosing) {
-				$this->isClosing = false; // A close response, all done.
-			}
-
-			fclose($this->socket);
-			$this->isConnected = false;
-		}
-
-		if (!$final) {
-			$this->hugePayload .= $payload;
-
-			return null;
-		}
-
-		if ($this->hugePayload) {
-			$payload = $this->hugePayload .= $payload;
-			$this->hugePayload = null;
-		}
-
-		return $payload;
-	}
-
-	/**
-	 * @param $final
-	 * @param $payload
-	 * @param $opcode
-	 * @param $masked
-	 * @throws \Exception
-	 */
-	protected function sendFragment($final, $payload, $opcode, $masked): void
-	{
-		// Binary string for header.
-		$frameHeadBin = '';
-		// Write FIN, final fragment bit.
-		$frameHeadBin .= (bool)$final ? '1' : '0';
-		// RSV 1, 2, & 3 false and unused.
-		$frameHeadBin .= '000';
-		// Opcode rest of the byte.
-		$frameHeadBin .= sprintf('%04b', self::$opcodes[$opcode]);
-		// Use masking?
-		$frameHeadBin .= $masked ? '1' : '0';
-
-		// 7 bits of payload length...
-		$payloadLen = strlen($payload);
-		if ($payloadLen > self::MAX_BYTES_READ) {
-			$frameHeadBin .= decbin(self::MASK_127);
-			$frameHeadBin .= sprintf('%064b', $payloadLen);
-		} else if ($payloadLen > self::MASK_125) {
-			$frameHeadBin .= decbin(self::MASK_126);
-			$frameHeadBin .= sprintf('%016b', $payloadLen);
-		} else {
-			$frameHeadBin .= sprintf('%07b', $payloadLen);
-		}
-
-		$frame = '';
-
-		// Write frame head to frame.
-		foreach (str_split($frameHeadBin, 8) as $binstr) {
-			$frame .= chr(bindec($binstr));
-		}
-		// Handle masking
-		if ($masked) {
-			// generate a random mask:
-			$mask = '';
-			for ($i = 0; $i < 4; $i++) {
-				$mask .= chr(random_int(0, 255));
-			}
-			$frame .= $mask;
-		}
-
-		// Append payload to frame:
-		for ($i = 0; $i < $payloadLen; $i++) {
-			$frame .= ($masked === true) ? $payload[$i] ^ $mask[$i % 4] : $payload[$i];
-		}
-
-		$this->write($frame);
-	}
-
-	/**
-	 * Sec-WebSocket-Key generator
-	 *
-	 * @return string   the 16 character length key
-	 * @throws \Exception
-	 */
-	private function generateKey(): string
-	{
-		$chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!"$&/()=[]{}0123456789';
-		$key = '';
-		$chLen = strlen($chars);
-		for ($i = 0; $i < self::KEY_GEN_LENGTH; $i++) {
-			$key .= $chars[random_int(0, $chLen - 1)];
-		}
-
-		return base64_encode($key);
-	}
-
-	/**
-	 * @param int $len
-	 * @return string|null
-	 * @throws ConnectionException
-	 */
-	protected function read(int $len): string|null
-	{
-		if ($this->socket && $this->isConnected()) {
-			return Middleware::stream_read($this->socket, $len);
-		}
-
-		return null;
-	}
-
-	/**
-	 * @param string $data
-	 * @return void
-	 * @throws ConnectionException
-	 */
-	protected function write(string $data): void
-	{
-		Middleware::stream_write($this->socket, $data);
-	}
+    /**
+     * Validates whether server sent valid upgrade response
+     *
+     * @param WebSocketConfig $config
+     * @param string $pathWithQuery
+     * @param string $key
+     * @throws ConnectionException
+     */
+    private function validateResponse(WebSocketConfig $config, string $pathWithQuery, string $key): void
+    {
+        $response = stream_get_line($this->socket, self::DEFAULT_RESPONSE_HEADER, "\r\n\r\n");
+        if (!preg_match(self::SEC_WEBSOCKET_ACCEPT_PTTRN, $response, $matches)) {
+            $address = $config->getScheme() . '://' . $config->getHost() . ':' . $config->getPort() . $pathWithQuery;
+            throw new ConnectionException(
+                "Connection to '{$address}' failed: Server sent invalid upgrade response:\n"
+                . $response, CommonsContract::CLIENT_INVALID_UPGRADE_RESPONSE
+            );
+        }
+
+        $keyAccept = trim($matches[1]);
+        $expectedResponse = base64_encode(pack('H*', sha1($key . self::SERVER_KEY_ACCEPT)));
+        if ($keyAccept !== $expectedResponse) {
+            throw new ConnectionException(
+                'Server sent bad upgrade response.',
+                CommonsContract::CLIENT_INVALID_UPGRADE_RESPONSE
+            );
+        }
+    }
+
+    /**
+     *  Gets host uri based on protocol
+     *
+     * @param WebSocketConfig $config
+     * @return string
+     * @throws BadUriException
+     */
+    private function getHostUri(WebSocketConfig $config): string
+    {
+        if (in_array($config->getScheme(), ['ws', 'wss'], true) === false) {
+            throw new BadUriException(
+                "Url should have scheme ws or wss, not '{$config->getScheme()}' from URI '$this->socketUrl' .",
+                CommonsContract::CLIENT_INCORRECT_SCHEME
+            );
+        }
+
+        return ($config->getScheme() === 'wss' ? 'ssl' : 'tcp') . '://' . $config->getHost();
+    }
+
+    /**
+     * @param string $data
+     * @return float|int
+     * @throws ConnectionException
+     */
+    private function getPayloadLength(string $data): float|int
+    {
+        $payloadLength = (int)ord($data[1]) & self::MASK_127; // Bits 1-7 in byte 1
+        if ($payloadLength > self::MASK_125) {
+            if ($payloadLength === self::MASK_126) {
+                $data = $this->read(2); // 126: Payload is a 16-bit unsigned int
+            } else {
+                $data = $this->read(8); // 127: Payload is a 64-bit unsigned int
+            }
+            $payloadLength = bindec(Toolkit::sprintB($data));
+        }
+
+        return $payloadLength;
+    }
+
+    /**
+     * @param string $data
+     * @param int $payloadLength
+     * @return string
+     * @throws ConnectionException
+     */
+    private function getPayloadData(string $data, int $payloadLength): string
+    {
+        // Masking?
+        $mask = (bool)(ord($data[1]) >> 7);  // Bit 0 in byte 1
+        $payload = '';
+        $maskingKey = '';
+
+        // Get masking key.
+        if ($mask) {
+            $maskingKey = $this->read(4);
+        }
+
+        // Get the actual payload, if any (might not be for e.g. close frames.
+        if ($payloadLength > 0) {
+            $data = $this->read($payloadLength);
+
+            if ($mask) {
+                // Unmask payload.
+                for ($i = 0; $i < $payloadLength; $i++) {
+                    $payload .= ($data[$i] ^ $maskingKey[$i % 4]);
+                }
+            } else {
+                $payload = $data;
+            }
+        }
+
+        return $payload;
+    }
+
+    /**
+     * @return string|null
+     * @throws \Exception
+     */
+    protected function receiveFragment(): string|null
+    {
+        $data = $this->read(2);
+        if (is_string($data) === false) {
+            return null;
+        }
+
+        $final = (bool)(ord($data[0]) & 1 << 7);
+
+        $opcodeInt = ord($data[0]) & 31;
+        $opcodeInts = array_flip(self::$opcodes);
+        if (!array_key_exists($opcodeInt, $opcodeInts)) {
+            throw new ConnectionException(
+                "Bad opcode in websocket frame: $opcodeInt",
+                CommonsContract::CLIENT_BAD_OPCODE
+            );
+        }
+
+        $opcode = $opcodeInts[$opcodeInt];
+
+        if ($opcode !== 'continuation') {
+            $this->lastOpcode = $opcode;
+        }
+
+        $payloadLength = $this->getPayloadLength($data);
+        $payload = $this->getPayloadData($data, $payloadLength);
+
+        if ($opcode === CommonsContract::EVENT_TYPE_CLOSE) {
+            if ($payloadLength >= 2) {
+                $statusBin = $payload[0] . $payload[1];
+                $status = bindec(sprintf('%08b%08b', ord($payload[0]), ord($payload[1])));
+                $this->closeStatus = $status;
+                $payload = substr($payload, 2);
+
+                if (!$this->isClosing) {
+                    $this->send($statusBin . 'Close acknowledged: ' . $status,
+                        CommonsContract::EVENT_TYPE_CLOSE); // Respond.
+                }
+            }
+
+            if ($this->isClosing) {
+                $this->isClosing = false; // A close response, all done.
+            }
+
+            fclose($this->socket);
+            $this->isConnected = false;
+        }
+
+        if (!$final) {
+            $this->hugePayload .= $payload;
+
+            return null;
+        }
+
+        if ($this->hugePayload) {
+            $payload = $this->hugePayload .= $payload;
+            $this->hugePayload = null;
+        }
+
+        return $payload;
+    }
+
+    /**
+     * @param $final
+     * @param $payload
+     * @param $opcode
+     * @param $masked
+     * @throws \Exception
+     */
+    protected function sendFragment($final, $payload, $opcode, $masked): void
+    {
+        // Binary string for header.
+        $frameHeadBin = '';
+        // Write FIN, final fragment bit.
+        $frameHeadBin .= (bool)$final ? '1' : '0';
+        // RSV 1, 2, & 3 false and unused.
+        $frameHeadBin .= '000';
+        // Opcode rest of the byte.
+        $frameHeadBin .= sprintf('%04b', self::$opcodes[$opcode]);
+        // Use masking?
+        $frameHeadBin .= $masked ? '1' : '0';
+
+        // 7 bits of payload length...
+        $payloadLen = strlen($payload);
+        if ($payloadLen > self::MAX_BYTES_READ) {
+            $frameHeadBin .= decbin(self::MASK_127);
+            $frameHeadBin .= sprintf('%064b', $payloadLen);
+        } else if ($payloadLen > self::MASK_125) {
+            $frameHeadBin .= decbin(self::MASK_126);
+            $frameHeadBin .= sprintf('%016b', $payloadLen);
+        } else {
+            $frameHeadBin .= sprintf('%07b', $payloadLen);
+        }
+
+        $frame = '';
+
+        // Write frame head to frame.
+        foreach (str_split($frameHeadBin, 8) as $binstr) {
+            $frame .= chr(bindec($binstr));
+        }
+        // Handle masking
+        if ($masked) {
+            // generate a random mask:
+            $mask = '';
+            for ($i = 0; $i < 4; $i++) {
+                $mask .= chr(random_int(0, 255));
+            }
+            $frame .= $mask;
+        }
+
+        // Append payload to frame:
+        for ($i = 0; $i < $payloadLen; $i++) {
+            $frame .= ($masked === true) ? $payload[$i] ^ $mask[$i % 4] : $payload[$i];
+        }
+
+        $this->write($frame);
+    }
+
+    /**
+     * Sec-WebSocket-Key generator
+     *
+     * @return string   the 16 character length key
+     * @throws \Exception
+     */
+    private function generateKey(): string
+    {
+        $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!"$&/()=[]{}0123456789';
+        $key = '';
+        $chLen = strlen($chars);
+        for ($i = 0; $i < self::KEY_GEN_LENGTH; $i++) {
+            $key .= $chars[random_int(0, $chLen - 1)];
+        }
+
+        return base64_encode($key);
+    }
+
+    /**
+     * @param int $len
+     * @return string|null
+     * @throws ConnectionException
+     */
+    protected function read(int $len): string|null
+    {
+        if ($this->socket && $this->isConnected()) {
+            return Middleware::stream_read($this->socket, $len);
+        }
+
+        return null;
+    }
+
+    /**
+     * @param string $data
+     * @return void
+     * @throws ConnectionException
+     */
+    protected function write(string $data): void
+    {
+        Middleware::stream_write($this->socket, $data);
+    }
 
 }
\ No newline at end of file

src/Traits/WSConnectionTrait.php

Indentation +246 added lines, -246 removed lines

@@ -18,251 +18,251 @@
 trait WSConnectionTrait
 {
 
-	/**
-	 * @var callable|null
-	 */
-	public $onOpen = null;
-
-	/**
-	 * @var callable|null
-	 */
-	public $onClose = null;
-
-	/**
-	 * @var callable|null
-	 */
-	public $onError = null;
-
-	/**
-	 * @var callable|null
-	 */
-	public $onMessage = null;
-
-	/**
-	 * @var callable|null
-	 */
-	public $onWhile = null;
-
-	/**
-	 * @var bool
-	 */
-	private bool $isConnected = false;
-
-	/**
-	 * @var bool
-	 */
-	private bool $isClosing = false;
-
-	/**
-	 * Default headers
-	 *
-	 * @var array
-	 */
-	private array $defaultHeaders = [
-		'Connection' => 'Upgrade',
-		'Upgrade' => 'WebSocket',
-		'Sec-Websocket-Version' => '13',
-	];
-
-	/**
-	 * @param string $socketUrl string that represents the URL of the Web Socket server. e.g. ws://localhost:1337 or wss://localhost:1337
-	 * @param ?WebSocketConfig $config The configuration for the Web Socket client
-	 */
-	public function connect(string $socketUrl, ?WebSocketConfig $config = null): void
-	{
-		try {
-			$this->config = $config ?? new WebSocketConfig();
-			$this->socketUrl = $socketUrl;
-			$urlParts = parse_url($this->socketUrl);
-
-			$this->config->setScheme($urlParts['scheme']);
-			$this->config->setHost($urlParts['host']);
-			$this->config->setUser($urlParts);
-			$this->config->setPassword($urlParts);
-			$this->config->setPort($urlParts);
-
-			$pathWithQuery = $this->getPathWithQuery($urlParts);
-			$hostUri = $this->getHostUri($this->config);
-
-			$context = $this->getStreamContext();
-			if ($this->config->hasProxy()) {
-				$this->socket = $this->proxy();
-			} else {
-				$this->socket = @stream_socket_client(
-					$hostUri . ':' . $this->config->getPort(),
-					$errno,
-					$errstr,
-					$this->config->getTimeout(),
-					STREAM_CLIENT_CONNECT,
-					$context
-				);
-			}
-
-			if ($this->socket === false) {
-				throw new ConnectionException(
-					"Could not open socket to \"{$this->config->getHost()}:{$this->config->getPort()}\": $errstr ($errno).",
-					CommonsContract::CLIENT_COULD_NOT_OPEN_SOCKET
-				);
-			}
-
-			stream_set_timeout($this->socket, $this->config->getTimeout());
-
-			$key = $this->generateKey();
-			$headers = array_merge($this->defaultHeaders, [
-				'Host' => $this->config->getHost() . ':' . $this->config->getPort(),
-				'User-Agent' => 'Easy-Http/' . self::VERSION . ' (PHP/' . PHP_VERSION . ')',
-				'Sec-WebSocket-Key' => $key,
-			]);
-
-			if ($this->config->getUser() || $this->config->getPassword()) {
-				$headers['authorization'] = 'Basic ' . base64_encode($this->config->getUser() . ':' . $this->config->getPassword()) . "\r\n";
-			}
-
-			if (!empty($this->config->getHeaders())) {
-				$headers = array_merge($headers, $this->config->getHeaders());
-			}
-
-			$header = $this->getHeaders($pathWithQuery, $headers);
-
-			$this->write($header);
-
-			$this->validateResponse($this->config, $pathWithQuery, $key);
-			$this->isConnected = true;
-			$this->whileIsConnected();
-
-		} catch (\Exception $e) {
-			$this->safeCall($this->onError, $this, new WebSocketException(
-				$e->getMessage(),
-				$e->getCode(),
-				$e->getPrevious()
-			));
-		}
-	}
-
-	/**
-	 * Reconnect to the Web Socket server
-	 *
-	 * @return void
-	 * @throws \Exception
-	 */
-	public function reconnect(): void
-	{
-		if ($this->isConnected) {
-			$this->close();
-		}
-
-		$this->connect($this->socketUrl, $this->config);
-	}
-
-	/**
-	 * @return void
-	 * @throws WebSocketException|\Exception
-	 */
-	private function whileIsConnected(): void
-	{
-		$this->safeCall($this->onOpen, $this);
-
-		while ($this->isConnected()) {
-			$this->safeCall($this->onWhile, $this);
-
-			if (is_string(($message = $this->receive()))) {
-				$this->safeCall($this->onMessage, $this, $message);
-			}
-		}
-
-		$this->safeCall($this->onClose, $this, $this->closeStatus);
-	}
-
-	/**
-	 * Execute events with safety of exceptions
-	 *
-	 * @param callable|null $callback
-	 * @param mixed ...$args
-	 * @return void
-	 */
-	private function safeCall(?callable $callback, ...$args): void
-	{
-		if (is_callable($callback) && $callback) {
-			call_user_func($callback, ...$args);
-		}
-	}
-
-	/**
-	 * Sends message to opened socket connection client->server
-	 *
-	 * @param $payload
-	 * @param string $opcode
-	 * @throws \Exception
-	 */
-	public function send($payload, string $opcode = CommonsContract::EVENT_TYPE_TEXT): void
-	{
-		if (!$this->isConnected) {
-			throw new \Exception(
-				"Can't send message. Connection is not established.",
-				CommonsContract::CLIENT_CONNECTION_NOT_ESTABLISHED
-			);
-		}
-
-		if (array_key_exists($opcode, self::$opcodes) === false) {
-			throw new BadOpcodeException(
-				sprintf("Bad opcode '%s'.  Try 'text' or 'binary'.", $opcode),
-				CommonsContract::CLIENT_BAD_OPCODE
-			);
-		}
-
-		$payloadLength = strlen($payload);
-		$fragmentCursor = 0;
-
-		while ($payloadLength > $fragmentCursor) {
-			$subPayload = substr($payload, $fragmentCursor, $this->config->getFragmentSize());
-			$fragmentCursor += $this->config->getFragmentSize();
-			$final = $payloadLength <= $fragmentCursor;
-			$this->sendFragment($final, $subPayload, $opcode, true);
-			$opcode = 'continuation';
-		}
-	}
-
-	/**
-	 * Receives message client<-server
-	 *
-	 * @return string|null
-	 * @throws \Exception
-	 */
-	public function receive(): string|null
-	{
-		if (!$this->isConnected && $this->isClosing === false) {
-			throw new WebSocketException(
-				"Your unexpectedly disconnected from the server",
-				CommonsContract::CLIENT_CONNECTION_NOT_ESTABLISHED
-			);
-		}
-
-		$this->hugePayload = '';
-
-		return $this->receiveFragment();
-	}
-
-	/**
-	 * Tell the socket to close.
-	 *
-	 * @param integer $status http://tools.ietf.org/html/rfc6455#section-7.4
-	 * @param string $message A closing message, max 125 bytes.
-	 * @return bool|null|string
-	 * @throws \Exception
-	 */
-	public function close(int $status = 1000, string $message = 'ttfn'): bool|null|string
-	{
-		$statusBin = sprintf('%016b', $status);
-		$statusStr = '';
-
-		foreach (str_split($statusBin, 8) as $binstr) {
-			$statusStr .= chr(bindec($binstr));
-		}
-
-		$this->send($statusStr . $message, CommonsContract::EVENT_TYPE_CLOSE);
-		$this->isClosing = true;
-
-		return $this->receive(); // Receiving a close frame will close the socket now.
-	}
+    /**
+     * @var callable|null
+     */
+    public $onOpen = null;
+
+    /**
+     * @var callable|null
+     */
+    public $onClose = null;
+
+    /**
+     * @var callable|null
+     */
+    public $onError = null;
+
+    /**
+     * @var callable|null
+     */
+    public $onMessage = null;
+
+    /**
+     * @var callable|null
+     */
+    public $onWhile = null;
+
+    /**
+     * @var bool
+     */
+    private bool $isConnected = false;
+
+    /**
+     * @var bool
+     */
+    private bool $isClosing = false;
+
+    /**
+     * Default headers
+     *
+     * @var array
+     */
+    private array $defaultHeaders = [
+        'Connection' => 'Upgrade',
+        'Upgrade' => 'WebSocket',
+        'Sec-Websocket-Version' => '13',
+    ];
+
+    /**
+     * @param string $socketUrl string that represents the URL of the Web Socket server. e.g. ws://localhost:1337 or wss://localhost:1337
+     * @param ?WebSocketConfig $config The configuration for the Web Socket client
+     */
+    public function connect(string $socketUrl, ?WebSocketConfig $config = null): void
+    {
+        try {
+            $this->config = $config ?? new WebSocketConfig();
+            $this->socketUrl = $socketUrl;
+            $urlParts = parse_url($this->socketUrl);
+
+            $this->config->setScheme($urlParts['scheme']);
+            $this->config->setHost($urlParts['host']);
+            $this->config->setUser($urlParts);
+            $this->config->setPassword($urlParts);
+            $this->config->setPort($urlParts);
+
+            $pathWithQuery = $this->getPathWithQuery($urlParts);
+            $hostUri = $this->getHostUri($this->config);
+
+            $context = $this->getStreamContext();
+            if ($this->config->hasProxy()) {
+                $this->socket = $this->proxy();
+            } else {
+                $this->socket = @stream_socket_client(
+                    $hostUri . ':' . $this->config->getPort(),
+                    $errno,
+                    $errstr,
+                    $this->config->getTimeout(),
+                    STREAM_CLIENT_CONNECT,
+                    $context
+                );
+            }
+
+            if ($this->socket === false) {
+                throw new ConnectionException(
+                    "Could not open socket to \"{$this->config->getHost()}:{$this->config->getPort()}\": $errstr ($errno).",
+                    CommonsContract::CLIENT_COULD_NOT_OPEN_SOCKET
+                );
+            }
+
+            stream_set_timeout($this->socket, $this->config->getTimeout());
+
+            $key = $this->generateKey();
+            $headers = array_merge($this->defaultHeaders, [
+                'Host' => $this->config->getHost() . ':' . $this->config->getPort(),
+                'User-Agent' => 'Easy-Http/' . self::VERSION . ' (PHP/' . PHP_VERSION . ')',
+                'Sec-WebSocket-Key' => $key,
+            ]);
+
+            if ($this->config->getUser() || $this->config->getPassword()) {
+                $headers['authorization'] = 'Basic ' . base64_encode($this->config->getUser() . ':' . $this->config->getPassword()) . "\r\n";
+            }
+
+            if (!empty($this->config->getHeaders())) {
+                $headers = array_merge($headers, $this->config->getHeaders());
+            }
+
+            $header = $this->getHeaders($pathWithQuery, $headers);
+
+            $this->write($header);
+
+            $this->validateResponse($this->config, $pathWithQuery, $key);
+            $this->isConnected = true;
+            $this->whileIsConnected();
+
+        } catch (\Exception $e) {
+            $this->safeCall($this->onError, $this, new WebSocketException(
+                $e->getMessage(),
+                $e->getCode(),
+                $e->getPrevious()
+            ));
+        }
+    }
+
+    /**
+     * Reconnect to the Web Socket server
+     *
+     * @return void
+     * @throws \Exception
+     */
+    public function reconnect(): void
+    {
+        if ($this->isConnected) {
+            $this->close();
+        }
+
+        $this->connect($this->socketUrl, $this->config);
+    }
+
+    /**
+     * @return void
+     * @throws WebSocketException|\Exception
+     */
+    private function whileIsConnected(): void
+    {
+        $this->safeCall($this->onOpen, $this);
+
+        while ($this->isConnected()) {
+            $this->safeCall($this->onWhile, $this);
+
+            if (is_string(($message = $this->receive()))) {
+                $this->safeCall($this->onMessage, $this, $message);
+            }
+        }
+
+        $this->safeCall($this->onClose, $this, $this->closeStatus);
+    }
+
+    /**
+     * Execute events with safety of exceptions
+     *
+     * @param callable|null $callback
+     * @param mixed ...$args
+     * @return void
+     */
+    private function safeCall(?callable $callback, ...$args): void
+    {
+        if (is_callable($callback) && $callback) {
+            call_user_func($callback, ...$args);
+        }
+    }
+
+    /**
+     * Sends message to opened socket connection client->server
+     *
+     * @param $payload
+     * @param string $opcode
+     * @throws \Exception
+     */
+    public function send($payload, string $opcode = CommonsContract::EVENT_TYPE_TEXT): void
+    {
+        if (!$this->isConnected) {
+            throw new \Exception(
+                "Can't send message. Connection is not established.",
+                CommonsContract::CLIENT_CONNECTION_NOT_ESTABLISHED
+            );
+        }
+
+        if (array_key_exists($opcode, self::$opcodes) === false) {
+            throw new BadOpcodeException(
+                sprintf("Bad opcode '%s'.  Try 'text' or 'binary'.", $opcode),
+                CommonsContract::CLIENT_BAD_OPCODE
+            );
+        }
+
+        $payloadLength = strlen($payload);
+        $fragmentCursor = 0;
+
+        while ($payloadLength > $fragmentCursor) {
+            $subPayload = substr($payload, $fragmentCursor, $this->config->getFragmentSize());
+            $fragmentCursor += $this->config->getFragmentSize();
+            $final = $payloadLength <= $fragmentCursor;
+            $this->sendFragment($final, $subPayload, $opcode, true);
+            $opcode = 'continuation';
+        }
+    }
+
+    /**
+     * Receives message client<-server
+     *
+     * @return string|null
+     * @throws \Exception
+     */
+    public function receive(): string|null
+    {
+        if (!$this->isConnected && $this->isClosing === false) {
+            throw new WebSocketException(
+                "Your unexpectedly disconnected from the server",
+                CommonsContract::CLIENT_CONNECTION_NOT_ESTABLISHED
+            );
+        }
+
+        $this->hugePayload = '';
+
+        return $this->receiveFragment();
+    }
+
+    /**
+     * Tell the socket to close.
+     *
+     * @param integer $status http://tools.ietf.org/html/rfc6455#section-7.4
+     * @param string $message A closing message, max 125 bytes.
+     * @return bool|null|string
+     * @throws \Exception
+     */
+    public function close(int $status = 1000, string $message = 'ttfn'): bool|null|string
+    {
+        $statusBin = sprintf('%016b', $status);
+        $statusStr = '';
+
+        foreach (str_split($statusBin, 8) as $binstr) {
+            $statusStr .= chr(bindec($binstr));
+        }
+
+        $this->send($statusStr . $message, CommonsContract::EVENT_TYPE_CLOSE);
+        $this->isClosing = true;
+
+        return $this->receive(); // Receiving a close frame will close the socket now.
+    }
 
 }
\ No newline at end of file

src/Utils/Toolkit.php

Indentation +34 added lines, -34 removed lines

@@ -96,42 +96,42 @@
         return (bool)preg_match_all('/' . $value . '/i', $string);
     }
 
-	/**
-	 * Millisecond sleep
-	 *
-	 * @param int $milliseconds The milliseconds
-	 * @return void
-	 */
-	public static function sleep(int $milliseconds): void
-	{
-		usleep($milliseconds * 1000);
-	}
+    /**
+     * Millisecond sleep
+     *
+     * @param int $milliseconds The milliseconds
+     * @return void
+     */
+    public static function sleep(int $milliseconds): void
+    {
+        usleep($milliseconds * 1000);
+    }
 
-	/**
-	 * Get current time in milliseconds
-	 *
-	 * @return int
-	 */
-	public static function time(): int
-	{
-		return (int)(microtime(true) * 1000);
-	}
+    /**
+     * Get current time in milliseconds
+     *
+     * @return int
+     */
+    public static function time(): int
+    {
+        return (int)(microtime(true) * 1000);
+    }
 
-	/**
-	 * Helper to convert a binary to a string of '0' and '1'.
-	 *
-	 * @param string $string
-	 * @return string
-	 */
-	public static function sprintB(string $string): string
-	{
-		$return = '';
-		$strLen = strlen($string);
-		for ($i = 0; $i < $strLen; $i++) {
-			$return .= sprintf('%08b', ord($string[$i]));
-		}
+    /**
+     * Helper to convert a binary to a string of '0' and '1'.
+     *
+     * @param string $string
+     * @return string
+     */
+    public static function sprintB(string $string): string
+    {
+        $return = '';
+        $strLen = strlen($string);
+        for ($i = 0; $i < $strLen; $i++) {
+            $return .= sprintf('%08b', ord($string[$i]));
+        }
 
-		return $return;
-	}
+        return $return;
+    }
 
 }
\ No newline at end of file

Spacing +2 added lines, -2 removed lines

@@ -93,7 +93,7 @@ 
      */
     public static function insensitiveString(string $string, string $value): bool
     {
-        return (bool)preg_match_all('/' . $value . '/i', $string);
+        return (bool) preg_match_all('/' . $value . '/i', $string);
     }
 
 	/**
@@ -114,7 +114,7 @@ 
 	 */
 	public static function time(): int
 	{
-		return (int)(microtime(true) * 1000);
+		return (int) (microtime(true) * 1000);
 	}
 
 	/**

src/WebSocket.php

Indentation +232 added lines, -232 removed lines

@@ -24,237 +24,237 @@
 class WebSocket implements WscCommonsContract
 {
 
-	use WSClientTrait;
-	use WSConnectionTrait;
-
-	/**
-	 * App version
-	 *
-	 * @var string
-	 */
-	public const VERSION = 'v1.2.0';
-
-	/**
-	 * @var resource|bool
-	 */
-	private $socket;
-
-	/**
-	 * @var string
-	 */
-	private string $lastOpcode;
-
-	/**
-	 * @var float|int
-	 */
-	private float|int $closeStatus;
-
-	/**
-	 * @var string|null
-	 */
-	private ?string $hugePayload;
-
-	/**
-	 * @var WebSocketConfig
-	 */
-	protected WebSocketConfig $config;
-
-	/**
-	 * @var string
-	 */
-	protected string $socketUrl;
-
-	/**
-	 * @var array|int[]
-	 */
-	private static array $opcodes = [
-		CommonsContract::EVENT_TYPE_CONTINUATION => 0,
-		CommonsContract::EVENT_TYPE_TEXT => 1,
-		CommonsContract::EVENT_TYPE_BINARY => 2,
-		CommonsContract::EVENT_TYPE_CLOSE => 8,
-		CommonsContract::EVENT_TYPE_PING => 9,
-		CommonsContract::EVENT_TYPE_PONG => 10,
-	];
-
-	/**
-	 * Sets parameters for Web Socket Client intercommunication
-	 *
-	 * @param ?SocketClient $client leave it empty if you want to use default socket client
-	 */
-	public function __construct(?SocketClient $client = null)
-	{
-		if ($client instanceof SocketClient) {
-
-			$this->onOpen = function ($socket) use ($client) {
-				$client->onOpen($socket);
-			};
-
-			$this->onClose = function ($socket, int $closeStatus) use ($client) {
-				$client->onClose($socket, $closeStatus);
-			};
-
-			$this->onError = function ($socket, WebSocketException $exception) use ($client) {
-				$client->onError($socket, $exception);
-			};
-
-			$this->onMessage = function ($socket, string $message) use ($client) {
-				$client->onMessage($socket, $message);
-			};
-		}
-
-		$this->config = $config ?? new WebSocketConfig();
-	}
-
-	/**
-	 * Init a proxy connection
-	 *
-	 * @return resource|false
-	 * @throws \InvalidArgumentException
-	 * @throws ConnectionException
-	 */
-	private function proxy()
-	{
-		$sock = @stream_socket_client(
-			WscCommonsContract::TCP_SCHEME . $this->config->getProxyIp() . ':' . $this->config->getProxyPort(),
-			$errno,
-			$errstr,
-			$this->config->getTimeout(),
-			STREAM_CLIENT_CONNECT,
-			$this->getStreamContext()
-		);
-
-		$write = "CONNECT {$this->config->getProxyIp()}:{$this->config->getProxyPort()} HTTP/1.1\r\n";
-		$auth = $this->config->getProxyAuth();
-
-		if ($auth !== NULL) {
-			$write .= "Proxy-Authorization: Basic {$auth}\r\n";
-		}
-
-		$write .= "\r\n";
-		fwrite($sock, $write);
-		$resp = fread($sock, 1024);
-
-		if (preg_match(self::PROXY_MATCH_RESP, $resp) === 1) {
-			return $sock;
-		}
-
-		throw new ConnectionException('Failed to connect to the host via proxy');
-	}
-
-	/**
-	 * @return mixed
-	 * @throws \InvalidArgumentException
-	 */
-	private function getStreamContext(): mixed
-	{
-		if ($this->config->getContext() !== null) {
-			// Suppress the error since we'll catch it below
-			if (@get_resource_type($this->config->getContext()) === 'stream-context') {
-				return $this->config->getContext();
-			}
-
-			throw new \InvalidArgumentException(
-				'Stream context is invalid',
-				CommonsContract::CLIENT_INVALID_STREAM_CONTEXT
-			);
-		}
-
-		return stream_context_create($this->config->getContextOptions());
-	}
-
-	/**
-	 * @param mixed $urlParts
-	 *
-	 * @return string
-	 */
-	private function getPathWithQuery(mixed $urlParts): string
-	{
-		$path = $urlParts['path'] ?? '/';
-		$query = $urlParts['query'] ?? '';
-		$fragment = $urlParts['fragment'] ?? '';
-		$pathWithQuery = $path;
-
-		if (!empty($query)) {
-			$pathWithQuery .= '?' . $query;
-		}
-
-		if (!empty($fragment)) {
-			$pathWithQuery .= '#' . $fragment;
-		}
-
-		return $pathWithQuery;
-	}
-
-	/**
-	 * @param string $pathWithQuery
-	 * @param array $headers
-	 *
-	 * @return string
-	 */
-	private function getHeaders(string $pathWithQuery, array $headers): string
-	{
-		return 'GET ' . $pathWithQuery . " HTTP/1.1\r\n"
-			. implode(
-				"\r\n",
-				array_map(
-					function ($key, $value) {
-						return "$key: $value";
-					},
-					array_keys($headers),
-					$headers
-				)
-			)
-			. "\r\n\r\n";
-	}
-
-	/**
-	 * @param int $timeout
-	 * @param null $microSecs
-	 *
-	 * @return void
-	 */
-	public function setTimeout(int $timeout, $microSecs = null): void
-	{
-		$this->config->setTimeout($timeout);
-		if ($this->socket && get_resource_type($this->socket) === 'stream') {
-			stream_set_timeout($this->socket, $timeout, $microSecs);
-		}
-	}
-
-	/**
-	 * @param string $name
-	 * @param array $arguments
-	 *
-	 * @return mixed
-	 * @throws \Exception
-	 */
-	public function __call(string $name, array $arguments): mixed
-	{
-		if (property_exists($this, $name)) {
-			return $this->$name;
-		}
-
-		if (method_exists($this, $name)) {
-			return call_user_func_array([$this, $name], $arguments);
-		}
-
-		if (str_starts_with($name, 'get')) {
-			$property = lcfirst(substr($name, 3));
-
-			if (property_exists($this, $property)) {
-				return $this->{$property};
-			}
-		}
-
-		if (str_starts_with($name, 'set')) {
-			$property = lcfirst(substr($name, 3));
-			if (property_exists($this, $property)) {
-				$this->{$property} = $arguments[0];
-				return $this;
-			}
-		}
-
-		throw new \Exception(sprintf("Method '%s' does not exist.", $name));
-	}
+    use WSClientTrait;
+    use WSConnectionTrait;
+
+    /**
+     * App version
+     *
+     * @var string
+     */
+    public const VERSION = 'v1.2.0';
+
+    /**
+     * @var resource|bool
+     */
+    private $socket;
+
+    /**
+     * @var string
+     */
+    private string $lastOpcode;
+
+    /**
+     * @var float|int
+     */
+    private float|int $closeStatus;
+
+    /**
+     * @var string|null
+     */
+    private ?string $hugePayload;
+
+    /**
+     * @var WebSocketConfig
+     */
+    protected WebSocketConfig $config;
+
+    /**
+     * @var string
+     */
+    protected string $socketUrl;
+
+    /**
+     * @var array|int[]
+     */
+    private static array $opcodes = [
+        CommonsContract::EVENT_TYPE_CONTINUATION => 0,
+        CommonsContract::EVENT_TYPE_TEXT => 1,
+        CommonsContract::EVENT_TYPE_BINARY => 2,
+        CommonsContract::EVENT_TYPE_CLOSE => 8,
+        CommonsContract::EVENT_TYPE_PING => 9,
+        CommonsContract::EVENT_TYPE_PONG => 10,
+    ];
+
+    /**
+     * Sets parameters for Web Socket Client intercommunication
+     *
+     * @param ?SocketClient $client leave it empty if you want to use default socket client
+     */
+    public function __construct(?SocketClient $client = null)
+    {
+        if ($client instanceof SocketClient) {
+
+            $this->onOpen = function ($socket) use ($client) {
+                $client->onOpen($socket);
+            };
+
+            $this->onClose = function ($socket, int $closeStatus) use ($client) {
+                $client->onClose($socket, $closeStatus);
+            };
+
+            $this->onError = function ($socket, WebSocketException $exception) use ($client) {
+                $client->onError($socket, $exception);
+            };
+
+            $this->onMessage = function ($socket, string $message) use ($client) {
+                $client->onMessage($socket, $message);
+            };
+        }
+
+        $this->config = $config ?? new WebSocketConfig();
+    }
+
+    /**
+     * Init a proxy connection
+     *
+     * @return resource|false
+     * @throws \InvalidArgumentException
+     * @throws ConnectionException
+     */
+    private function proxy()
+    {
+        $sock = @stream_socket_client(
+            WscCommonsContract::TCP_SCHEME . $this->config->getProxyIp() . ':' . $this->config->getProxyPort(),
+            $errno,
+            $errstr,
+            $this->config->getTimeout(),
+            STREAM_CLIENT_CONNECT,
+            $this->getStreamContext()
+        );
+
+        $write = "CONNECT {$this->config->getProxyIp()}:{$this->config->getProxyPort()} HTTP/1.1\r\n";
+        $auth = $this->config->getProxyAuth();
+
+        if ($auth !== NULL) {
+            $write .= "Proxy-Authorization: Basic {$auth}\r\n";
+        }
+
+        $write .= "\r\n";
+        fwrite($sock, $write);
+        $resp = fread($sock, 1024);
+
+        if (preg_match(self::PROXY_MATCH_RESP, $resp) === 1) {
+            return $sock;
+        }
+
+        throw new ConnectionException('Failed to connect to the host via proxy');
+    }
+
+    /**
+     * @return mixed
+     * @throws \InvalidArgumentException
+     */
+    private function getStreamContext(): mixed
+    {
+        if ($this->config->getContext() !== null) {
+            // Suppress the error since we'll catch it below
+            if (@get_resource_type($this->config->getContext()) === 'stream-context') {
+                return $this->config->getContext();
+            }
+
+            throw new \InvalidArgumentException(
+                'Stream context is invalid',
+                CommonsContract::CLIENT_INVALID_STREAM_CONTEXT
+            );
+        }
+
+        return stream_context_create($this->config->getContextOptions());
+    }
+
+    /**
+     * @param mixed $urlParts
+     *
+     * @return string
+     */
+    private function getPathWithQuery(mixed $urlParts): string
+    {
+        $path = $urlParts['path'] ?? '/';
+        $query = $urlParts['query'] ?? '';
+        $fragment = $urlParts['fragment'] ?? '';
+        $pathWithQuery = $path;
+
+        if (!empty($query)) {
+            $pathWithQuery .= '?' . $query;
+        }
+
+        if (!empty($fragment)) {
+            $pathWithQuery .= '#' . $fragment;
+        }
+
+        return $pathWithQuery;
+    }
+
+    /**
+     * @param string $pathWithQuery
+     * @param array $headers
+     *
+     * @return string
+     */
+    private function getHeaders(string $pathWithQuery, array $headers): string
+    {
+        return 'GET ' . $pathWithQuery . " HTTP/1.1\r\n"
+            . implode(
+                "\r\n",
+                array_map(
+                    function ($key, $value) {
+                        return "$key: $value";
+                    },
+                    array_keys($headers),
+                    $headers
+                )
+            )
+            . "\r\n\r\n";
+    }
+
+    /**
+     * @param int $timeout
+     * @param null $microSecs
+     *
+     * @return void
+     */
+    public function setTimeout(int $timeout, $microSecs = null): void
+    {
+        $this->config->setTimeout($timeout);
+        if ($this->socket && get_resource_type($this->socket) === 'stream') {
+            stream_set_timeout($this->socket, $timeout, $microSecs);
+        }
+    }
+
+    /**
+     * @param string $name
+     * @param array $arguments
+     *
+     * @return mixed
+     * @throws \Exception
+     */
+    public function __call(string $name, array $arguments): mixed
+    {
+        if (property_exists($this, $name)) {
+            return $this->$name;
+        }
+
+        if (method_exists($this, $name)) {
+            return call_user_func_array([$this, $name], $arguments);
+        }
+
+        if (str_starts_with($name, 'get')) {
+            $property = lcfirst(substr($name, 3));
+
+            if (property_exists($this, $property)) {
+                return $this->{$property};
+            }
+        }
+
+        if (str_starts_with($name, 'set')) {
+            $property = lcfirst(substr($name, 3));
+            if (property_exists($this, $property)) {
+                $this->{$property} = $arguments[0];
+                return $this;
+            }
+        }
+
+        throw new \Exception(sprintf("Method '%s' does not exist.", $name));
+    }
 
 }
\ No newline at end of file