sunrise-php / http-message

functions/server_request_method.php

Indentation +2 added lines, -2 removed lines

@@ -23,7 +23,7 @@
  */
 function server_request_method(?array $serverParams = null): string
 {
-    $serverParams ??= $_SERVER;
+	$serverParams ??= $_SERVER;
 
-    return $serverParams['REQUEST_METHOD'] ?? Request::METHOD_GET;
+	return $serverParams['REQUEST_METHOD'] ?? Request::METHOD_GET;
 }

functions/server_request_protocol_version.php

Indentation +15 added lines, -15 removed lines

@@ -29,24 +29,24 @@
  */
 function server_request_protocol_version(?array $serverParams = null): string
 {
-    $serverParams ??= $_SERVER;
+	$serverParams ??= $_SERVER;
 
-    if (!isset($serverParams['SERVER_PROTOCOL'])) {
-        return '1.1';
-    }
+	if (!isset($serverParams['SERVER_PROTOCOL'])) {
+		return '1.1';
+	}
 
-    // "HTTP" "/" 1*digit "." 1*digit
-    sscanf($serverParams['SERVER_PROTOCOL'], 'HTTP/%d.%d', $major, $minor);
+	// "HTTP" "/" 1*digit "." 1*digit
+	sscanf($serverParams['SERVER_PROTOCOL'], 'HTTP/%d.%d', $major, $minor);
 
-    // e.g.: HTTP/1.1
-    if (isset($minor)) {
-        return sprintf('%d.%d', $major, $minor);
-    }
+	// e.g.: HTTP/1.1
+	if (isset($minor)) {
+		return sprintf('%d.%d', $major, $minor);
+	}
 
-    // e.g.: HTTP/2
-    if (isset($major)) {
-        return sprintf('%d', $major);
-    }
+	// e.g.: HTTP/2
+	if (isset($major)) {
+		return sprintf('%d', $major);
+	}
 
-    return '1.1';
+	return '1.1';
 }

functions/server_request_uri.php

Indentation +27 added lines, -27 removed lines

@@ -32,35 +32,35 @@
  */
 function server_request_uri(?array $serverParams = null): UriInterface
 {
-    $serverParams ??= $_SERVER;
+	$serverParams ??= $_SERVER;
 
-    if (array_key_exists('HTTPS', $serverParams)) {
-        if (! ('off' === $serverParams['HTTPS'])) {
-            $scheme = 'https://';
-        }
-    }
+	if (array_key_exists('HTTPS', $serverParams)) {
+		if (! ('off' === $serverParams['HTTPS'])) {
+			$scheme = 'https://';
+		}
+	}
 
-    if (array_key_exists('HTTP_HOST', $serverParams)) {
-        $host = $serverParams['HTTP_HOST'];
-    } elseif (array_key_exists('SERVER_NAME', $serverParams)) {
-        $host = $serverParams['SERVER_NAME'];
-        if (array_key_exists('SERVER_PORT', $serverParams)) {
-            $host .= ':' . $serverParams['SERVER_PORT'];
-        }
-    }
+	if (array_key_exists('HTTP_HOST', $serverParams)) {
+		$host = $serverParams['HTTP_HOST'];
+	} elseif (array_key_exists('SERVER_NAME', $serverParams)) {
+		$host = $serverParams['SERVER_NAME'];
+		if (array_key_exists('SERVER_PORT', $serverParams)) {
+			$host .= ':' . $serverParams['SERVER_PORT'];
+		}
+	}
 
-    if (array_key_exists('REQUEST_URI', $serverParams)) {
-        $target = $serverParams['REQUEST_URI'];
-    } elseif (array_key_exists('PHP_SELF', $serverParams)) {
-        $target = $serverParams['PHP_SELF'];
-        if (array_key_exists('QUERY_STRING', $serverParams)) {
-            $target .= '?' . $serverParams['QUERY_STRING'];
-        }
-    }
+	if (array_key_exists('REQUEST_URI', $serverParams)) {
+		$target = $serverParams['REQUEST_URI'];
+	} elseif (array_key_exists('PHP_SELF', $serverParams)) {
+		$target = $serverParams['PHP_SELF'];
+		if (array_key_exists('QUERY_STRING', $serverParams)) {
+			$target .= '?' . $serverParams['QUERY_STRING'];
+		}
+	}
 
-    return new Uri(
-        ($scheme ?? 'http://') .
-        ($host ?? 'localhost') .
-        ($target ?? '/')
-    );
+	return new Uri(
+		($scheme ?? 'http://') .
+		($host ?? 'localhost') .
+		($target ?? '/')
+	);
 }

Spacing +1 added lines, -1 removed lines

@@ -35,7 +35,7 @@
     $serverParams ??= $_SERVER;
 
     if (array_key_exists('HTTPS', $serverParams)) {
-        if (! ('off' === $serverParams['HTTPS'])) {
+        if (!('off' === $serverParams['HTTPS'])) {
             $scheme = 'https://';
         }
     }

src/Response/JsonResponse.php

Indentation +46 added lines, -46 removed lines

@@ -36,57 +36,57 @@
 final class JsonResponse extends Response
 {
 
-    /**
-     * Constructor of the class
-     *
-     * @param int $statusCode
-     * @param mixed $data
-     * @param int $flags
-     * @param int $depth
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct(int $statusCode, $data, int $flags = 0, int $depth = 512)
-    {
-        parent::__construct($statusCode);
+	/**
+	 * Constructor of the class
+	 *
+	 * @param int $statusCode
+	 * @param mixed $data
+	 * @param int $flags
+	 * @param int $depth
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct(int $statusCode, $data, int $flags = 0, int $depth = 512)
+	{
+		parent::__construct($statusCode);
 
-        $this->setBody($this->createBody($data, $flags, $depth));
+		$this->setBody($this->createBody($data, $flags, $depth));
 
-        $this->setHeader('Content-Type', 'application/json; charset=utf-8');
-    }
+		$this->setHeader('Content-Type', 'application/json; charset=utf-8');
+	}
 
-    /**
-     * Creates the response body from the given JSON data
-     *
-     * @param mixed $data
-     * @param int $flags
-     * @param int $depth
-     *
-     * @return StreamInterface
-     *
-     * @throws InvalidArgumentException
-     */
-    private function createBody($data, int $flags, int $depth): StreamInterface
-    {
-        if ($data instanceof StreamInterface) {
-            return $data;
-        }
+	/**
+	 * Creates the response body from the given JSON data
+	 *
+	 * @param mixed $data
+	 * @param int $flags
+	 * @param int $depth
+	 *
+	 * @return StreamInterface
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	private function createBody($data, int $flags, int $depth): StreamInterface
+	{
+		if ($data instanceof StreamInterface) {
+			return $data;
+		}
 
-        $flags |= JSON_THROW_ON_ERROR;
+		$flags |= JSON_THROW_ON_ERROR;
 
-        try {
-            $payload = json_encode($data, $flags, $depth);
-        } catch (JsonException $e) {
-            throw new InvalidArgumentException(sprintf(
-                'Unable to create JSON response due to invalid JSON data: %s',
-                $e->getMessage()
-            ), 0, $e);
-        }
+		try {
+			$payload = json_encode($data, $flags, $depth);
+		} catch (JsonException $e) {
+			throw new InvalidArgumentException(sprintf(
+				'Unable to create JSON response due to invalid JSON data: %s',
+				$e->getMessage()
+			), 0, $e);
+		}
 
-        $stream = new PhpTempStream('r+b');
-        $stream->write($payload);
-        $stream->rewind();
+		$stream = new PhpTempStream('r+b');
+		$stream->write($payload);
+		$stream->rewind();
 
-        return $stream;
-    }
+		return $stream;
+	}
 }

src/Stream/PhpMemoryStream.php

Indentation +9 added lines, -9 removed lines

@@ -27,13 +27,13 @@
 final class PhpMemoryStream extends Stream
 {
 
-    /**
-     * Constructor of the class
-     *
-     * @param string $mode
-     */
-    public function __construct(string $mode = 'r+b')
-    {
-        parent::__construct(fopen('php://memory', $mode));
-    }
+	/**
+	 * Constructor of the class
+	 *
+	 * @param string $mode
+	 */
+	public function __construct(string $mode = 'r+b')
+	{
+		parent::__construct(fopen('php://memory', $mode));
+	}
 }

src/Stream/PhpInputStream.php

Indentation +11 added lines, -11 removed lines

@@ -28,18 +28,18 @@
 final class PhpInputStream extends Stream
 {
 
-    /**
-     * Constructor of the class
-     */
-    public function __construct()
-    {
-        $input = fopen('php://input', 'rb');
-        $resource = fopen('php://temp', 'r+b');
+	/**
+	 * Constructor of the class
+	 */
+	public function __construct()
+	{
+		$input = fopen('php://input', 'rb');
+		$resource = fopen('php://temp', 'r+b');
 
-        stream_copy_to_stream($input, $resource);
+		stream_copy_to_stream($input, $resource);
 
-        parent::__construct($resource);
+		parent::__construct($resource);
 
-        $this->rewind();
-    }
+		$this->rewind();
+	}
 }

src/Stream/FileStream.php

Indentation +26 added lines, -26 removed lines

@@ -31,30 +31,30 @@
 final class FileStream extends Stream
 {
 
-    /**
-     * Constructor of the class
-     *
-     * @param string $filename
-     * @param string $mode
-     *
-     * @throws RuntimeException
-     */
-    public function __construct(string $filename, string $mode)
-    {
-        try {
-            $resource = fopen($filename, $mode);
-        } catch (Throwable $e) {
-            $resource = false;
-        }
-
-        if (!is_resource($resource)) {
-            throw new RuntimeException(sprintf(
-                'Unable to open the file "%s" in the mode "%s"',
-                $filename,
-                $mode
-            ));
-        }
-
-        parent::__construct($resource);
-    }
+	/**
+	 * Constructor of the class
+	 *
+	 * @param string $filename
+	 * @param string $mode
+	 *
+	 * @throws RuntimeException
+	 */
+	public function __construct(string $filename, string $mode)
+	{
+		try {
+			$resource = fopen($filename, $mode);
+		} catch (Throwable $e) {
+			$resource = false;
+		}
+
+		if (!is_resource($resource)) {
+			throw new RuntimeException(sprintf(
+				'Unable to open the file "%s" in the mode "%s"',
+				$filename,
+				$mode
+			));
+		}
+
+		parent::__construct($resource);
+	}
 }

src/Stream/TmpfileStream.php

Indentation +19 added lines, -19 removed lines

@@ -35,23 +35,23 @@
 final class TmpfileStream extends Stream
 {
 
-    /**
-     * Constructor of the class
-     *
-     * @throws RuntimeException
-     */
-    public function __construct()
-    {
-        $dirname = sys_get_temp_dir();
-        if (!is_writable($dirname)) {
-            throw new RuntimeException('Temporary files directory is not writable');
-        }
-
-        $resource = tmpfile();
-        if (!is_resource($resource)) {
-            throw new RuntimeException('Temporary file cannot be created or opened');
-        }
-
-        parent::__construct($resource);
-    }
+	/**
+	 * Constructor of the class
+	 *
+	 * @throws RuntimeException
+	 */
+	public function __construct()
+	{
+		$dirname = sys_get_temp_dir();
+		if (!is_writable($dirname)) {
+			throw new RuntimeException('Temporary files directory is not writable');
+		}
+
+		$resource = tmpfile();
+		if (!is_resource($resource)) {
+			throw new RuntimeException('Temporary file cannot be created or opened');
+		}
+
+		parent::__construct($resource);
+	}
 }

src/Stream.php

Indentation +382 added lines, -382 removed lines

@@ -47,386 +47,386 @@
 class Stream implements StreamInterface
 {
 
-    /**
-     * The stream resource
-     *
-     * @var resource|null
-     */
-    private $resource;
-
-    /**
-     * Signals to close the stream on destruction
-     *
-     * @var bool
-     */
-    private $autoClose;
-
-    /**
-     * Constructor of the class
-     *
-     * @param mixed $resource
-     * @param bool $autoClose
-     *
-     * @throws InvalidArgumentException
-     *         If the stream cannot be initialized with the resource.
-     */
-    public function __construct($resource, bool $autoClose = true)
-    {
-        if (!is_resource($resource)) {
-            throw new InvalidArgumentException('Unexpected stream resource');
-        }
-
-        $this->resource = $resource;
-        $this->autoClose = $autoClose;
-    }
-
-    /**
-     * Creates a stream
-     *
-     * @param mixed $resource
-     *
-     * @return StreamInterface
-     *
-     * @throws InvalidArgumentException
-     *         If the stream cannot be initialized with the resource.
-     */
-    public static function create($resource): StreamInterface
-    {
-        if ($resource instanceof StreamInterface) {
-            return $resource;
-        }
-
-        return new self($resource);
-    }
-
-    /**
-     * Destructor of the class
-     */
-    public function __destruct()
-    {
-        if ($this->autoClose) {
-            $this->close();
-        }
-    }
-
-    /**
-     * Detaches a resource from the stream
-     *
-     * Returns NULL if the stream already without a resource.
-     *
-     * @return resource|null
-     */
-    public function detach()
-    {
-        $resource = $this->resource;
-        $this->resource = null;
-
-        return $resource;
-    }
-
-    /**
-     * Closes the stream
-     *
-     * @link http://php.net/manual/en/function.fclose.php
-     *
-     * @return void
-     */
-    public function close(): void
-    {
-        $resource = $this->detach();
-        if (!is_resource($resource)) {
-            return;
-        }
-
-        fclose($resource);
-    }
-
-    /**
-     * Checks if the end of the stream is reached
-     *
-     * @link http://php.net/manual/en/function.feof.php
-     *
-     * @return bool
-     */
-    public function eof(): bool
-    {
-        if (!is_resource($this->resource)) {
-            return true;
-        }
-
-        return feof($this->resource);
-    }
-
-    /**
-     * Gets the stream pointer position
-     *
-     * @link http://php.net/manual/en/function.ftell.php
-     *
-     * @return int
-     *
-     * @throws RuntimeException
-     */
-    public function tell(): int
-    {
-        if (!is_resource($this->resource)) {
-            throw new RuntimeException('The stream without a resource so the operation is not possible');
-        }
-
-        $result = ftell($this->resource);
-        if ($result === false) {
-            throw new RuntimeException('Unable to get the stream pointer position');
-        }
-
-        return $result;
-    }
-
-    /**
-     * Checks if the stream is seekable
-     *
-     * @return bool
-     */
-    public function isSeekable(): bool
-    {
-        if (!is_resource($this->resource)) {
-            return false;
-        }
-
-        /** @var array{seekable: bool} */
-        $metadata = stream_get_meta_data($this->resource);
-
-        return $metadata['seekable'];
-    }
-
-    /**
-     * Moves the stream pointer to the beginning
-     *
-     * @return void
-     *
-     * @throws RuntimeException
-     */
-    public function rewind(): void
-    {
-        $this->seek(0);
-    }
-
-    /**
-     * Moves the stream pointer to the given position
-     *
-     * @link http://php.net/manual/en/function.fseek.php
-     *
-     * @param int $offset
-     * @param int $whence
-     *
-     * @return void
-     *
-     * @throws RuntimeException
-     */
-    public function seek($offset, $whence = SEEK_SET): void
-    {
-        if (!is_resource($this->resource)) {
-            throw new RuntimeException('The stream without a resource so the operation is not possible');
-        }
-
-        if (!$this->isSeekable()) {
-            throw new RuntimeException('Stream is not seekable');
-        }
-
-        $result = fseek($this->resource, $offset, $whence);
-        if ($result !== 0) {
-            throw new RuntimeException('Unable to move the stream pointer position');
-        }
-    }
-
-    /**
-     * Checks if the stream is writable
-     *
-     * @return bool
-     */
-    public function isWritable(): bool
-    {
-        if (!is_resource($this->resource)) {
-            return false;
-        }
-
-        /** @var array{mode: string} */
-        $metadata = stream_get_meta_data($this->resource);
-
-        return strpbrk($metadata['mode'], '+acwx') !== false;
-    }
-
-    /**
-     * Writes the given string to the stream
-     *
-     * Returns the number of bytes written to the stream.
-     *
-     * @link http://php.net/manual/en/function.fwrite.php
-     *
-     * @param string $string
-     *
-     * @return int
-     *
-     * @throws RuntimeException
-     */
-    public function write($string): int
-    {
-        if (!is_resource($this->resource)) {
-            throw new RuntimeException('The stream without a resource so the operation is not possible');
-        }
-
-        if (!$this->isWritable()) {
-            throw new RuntimeException('Stream is not writable');
-        }
-
-        $result = fwrite($this->resource, $string);
-        if ($result === false) {
-            throw new RuntimeException('Unable to write to the stream');
-        }
-
-        return $result;
-    }
-
-    /**
-     * Checks if the stream is readable
-     *
-     * @return bool
-     */
-    public function isReadable(): bool
-    {
-        if (!is_resource($this->resource)) {
-            return false;
-        }
-
-        /** @var array{mode: string} */
-        $metadata = stream_get_meta_data($this->resource);
-
-        return strpbrk($metadata['mode'], '+r') !== false;
-    }
-
-    /**
-     * Reads the given number of bytes from the stream
-     *
-     * @link http://php.net/manual/en/function.fread.php
-     *
-     * @param int $length
-     *
-     * @return string
-     *
-     * @throws RuntimeException
-     */
-    public function read($length): string
-    {
-        if (!is_resource($this->resource)) {
-            throw new RuntimeException('The stream without a resource so the operation is not possible');
-        }
-
-        if (!$this->isReadable()) {
-            throw new RuntimeException('Stream is not readable');
-        }
-
-        $result = fread($this->resource, $length);
-        if ($result === false) {
-            throw new RuntimeException('Unable to read from the stream');
-        }
-
-        return $result;
-    }
-
-    /**
-     * Reads the remainder of the stream
-     *
-     * @link http://php.net/manual/en/function.stream-get-contents.php
-     *
-     * @return string
-     *
-     * @throws RuntimeException
-     */
-    public function getContents(): string
-    {
-        if (!is_resource($this->resource)) {
-            throw new RuntimeException('The stream without a resource so the operation is not possible');
-        }
-
-        if (!$this->isReadable()) {
-            throw new RuntimeException('Stream is not readable');
-        }
-
-        $result = stream_get_contents($this->resource);
-        if ($result === false) {
-            throw new RuntimeException('Unable to read the remainder of the stream');
-        }
-
-        return $result;
-    }
-
-    /**
-     * Gets the stream metadata
-     *
-     * @link http://php.net/manual/en/function.stream-get-meta-data.php
-     *
-     * @param string|null $key
-     *
-     * @return mixed
-     */
-    public function getMetadata($key = null)
-    {
-        if (!is_resource($this->resource)) {
-            return null;
-        }
-
-        $metadata = stream_get_meta_data($this->resource);
-        if ($key === null) {
-            return $metadata;
-        }
-
-        return $metadata[$key] ?? null;
-    }
-
-    /**
-     * Gets the stream size
-     *
-     * Returns NULL if the stream without a resource,
-     * or if the stream size cannot be determined.
-     *
-     * @link http://php.net/manual/en/function.fstat.php
-     *
-     * @return int|null
-     */
-    public function getSize(): ?int
-    {
-        if (!is_resource($this->resource)) {
-            return null;
-        }
-
-        /** @var array{size: int}|false */
-        $stats = fstat($this->resource);
-        if ($stats === false) {
-            return null;
-        }
-
-        return $stats['size'];
-    }
-
-    /**
-     * Converts the stream to a string
-     *
-     * @link http://php.net/manual/en/language.oop5.magic.php#object.tostring
-     *
-     * @return string
-     */
-    public function __toString(): string
-    {
-        if (!$this->isReadable()) {
-            return '';
-        }
-
-        try {
-            if ($this->isSeekable()) {
-                $this->rewind();
-            }
-
-            return $this->getContents();
-        } catch (Throwable $e) {
-            return '';
-        }
-    }
+	/**
+	 * The stream resource
+	 *
+	 * @var resource|null
+	 */
+	private $resource;
+
+	/**
+	 * Signals to close the stream on destruction
+	 *
+	 * @var bool
+	 */
+	private $autoClose;
+
+	/**
+	 * Constructor of the class
+	 *
+	 * @param mixed $resource
+	 * @param bool $autoClose
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the stream cannot be initialized with the resource.
+	 */
+	public function __construct($resource, bool $autoClose = true)
+	{
+		if (!is_resource($resource)) {
+			throw new InvalidArgumentException('Unexpected stream resource');
+		}
+
+		$this->resource = $resource;
+		$this->autoClose = $autoClose;
+	}
+
+	/**
+	 * Creates a stream
+	 *
+	 * @param mixed $resource
+	 *
+	 * @return StreamInterface
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the stream cannot be initialized with the resource.
+	 */
+	public static function create($resource): StreamInterface
+	{
+		if ($resource instanceof StreamInterface) {
+			return $resource;
+		}
+
+		return new self($resource);
+	}
+
+	/**
+	 * Destructor of the class
+	 */
+	public function __destruct()
+	{
+		if ($this->autoClose) {
+			$this->close();
+		}
+	}
+
+	/**
+	 * Detaches a resource from the stream
+	 *
+	 * Returns NULL if the stream already without a resource.
+	 *
+	 * @return resource|null
+	 */
+	public function detach()
+	{
+		$resource = $this->resource;
+		$this->resource = null;
+
+		return $resource;
+	}
+
+	/**
+	 * Closes the stream
+	 *
+	 * @link http://php.net/manual/en/function.fclose.php
+	 *
+	 * @return void
+	 */
+	public function close(): void
+	{
+		$resource = $this->detach();
+		if (!is_resource($resource)) {
+			return;
+		}
+
+		fclose($resource);
+	}
+
+	/**
+	 * Checks if the end of the stream is reached
+	 *
+	 * @link http://php.net/manual/en/function.feof.php
+	 *
+	 * @return bool
+	 */
+	public function eof(): bool
+	{
+		if (!is_resource($this->resource)) {
+			return true;
+		}
+
+		return feof($this->resource);
+	}
+
+	/**
+	 * Gets the stream pointer position
+	 *
+	 * @link http://php.net/manual/en/function.ftell.php
+	 *
+	 * @return int
+	 *
+	 * @throws RuntimeException
+	 */
+	public function tell(): int
+	{
+		if (!is_resource($this->resource)) {
+			throw new RuntimeException('The stream without a resource so the operation is not possible');
+		}
+
+		$result = ftell($this->resource);
+		if ($result === false) {
+			throw new RuntimeException('Unable to get the stream pointer position');
+		}
+
+		return $result;
+	}
+
+	/**
+	 * Checks if the stream is seekable
+	 *
+	 * @return bool
+	 */
+	public function isSeekable(): bool
+	{
+		if (!is_resource($this->resource)) {
+			return false;
+		}
+
+		/** @var array{seekable: bool} */
+		$metadata = stream_get_meta_data($this->resource);
+
+		return $metadata['seekable'];
+	}
+
+	/**
+	 * Moves the stream pointer to the beginning
+	 *
+	 * @return void
+	 *
+	 * @throws RuntimeException
+	 */
+	public function rewind(): void
+	{
+		$this->seek(0);
+	}
+
+	/**
+	 * Moves the stream pointer to the given position
+	 *
+	 * @link http://php.net/manual/en/function.fseek.php
+	 *
+	 * @param int $offset
+	 * @param int $whence
+	 *
+	 * @return void
+	 *
+	 * @throws RuntimeException
+	 */
+	public function seek($offset, $whence = SEEK_SET): void
+	{
+		if (!is_resource($this->resource)) {
+			throw new RuntimeException('The stream without a resource so the operation is not possible');
+		}
+
+		if (!$this->isSeekable()) {
+			throw new RuntimeException('Stream is not seekable');
+		}
+
+		$result = fseek($this->resource, $offset, $whence);
+		if ($result !== 0) {
+			throw new RuntimeException('Unable to move the stream pointer position');
+		}
+	}
+
+	/**
+	 * Checks if the stream is writable
+	 *
+	 * @return bool
+	 */
+	public function isWritable(): bool
+	{
+		if (!is_resource($this->resource)) {
+			return false;
+		}
+
+		/** @var array{mode: string} */
+		$metadata = stream_get_meta_data($this->resource);
+
+		return strpbrk($metadata['mode'], '+acwx') !== false;
+	}
+
+	/**
+	 * Writes the given string to the stream
+	 *
+	 * Returns the number of bytes written to the stream.
+	 *
+	 * @link http://php.net/manual/en/function.fwrite.php
+	 *
+	 * @param string $string
+	 *
+	 * @return int
+	 *
+	 * @throws RuntimeException
+	 */
+	public function write($string): int
+	{
+		if (!is_resource($this->resource)) {
+			throw new RuntimeException('The stream without a resource so the operation is not possible');
+		}
+
+		if (!$this->isWritable()) {
+			throw new RuntimeException('Stream is not writable');
+		}
+
+		$result = fwrite($this->resource, $string);
+		if ($result === false) {
+			throw new RuntimeException('Unable to write to the stream');
+		}
+
+		return $result;
+	}
+
+	/**
+	 * Checks if the stream is readable
+	 *
+	 * @return bool
+	 */
+	public function isReadable(): bool
+	{
+		if (!is_resource($this->resource)) {
+			return false;
+		}
+
+		/** @var array{mode: string} */
+		$metadata = stream_get_meta_data($this->resource);
+
+		return strpbrk($metadata['mode'], '+r') !== false;
+	}
+
+	/**
+	 * Reads the given number of bytes from the stream
+	 *
+	 * @link http://php.net/manual/en/function.fread.php
+	 *
+	 * @param int $length
+	 *
+	 * @return string
+	 *
+	 * @throws RuntimeException
+	 */
+	public function read($length): string
+	{
+		if (!is_resource($this->resource)) {
+			throw new RuntimeException('The stream without a resource so the operation is not possible');
+		}
+
+		if (!$this->isReadable()) {
+			throw new RuntimeException('Stream is not readable');
+		}
+
+		$result = fread($this->resource, $length);
+		if ($result === false) {
+			throw new RuntimeException('Unable to read from the stream');
+		}
+
+		return $result;
+	}
+
+	/**
+	 * Reads the remainder of the stream
+	 *
+	 * @link http://php.net/manual/en/function.stream-get-contents.php
+	 *
+	 * @return string
+	 *
+	 * @throws RuntimeException
+	 */
+	public function getContents(): string
+	{
+		if (!is_resource($this->resource)) {
+			throw new RuntimeException('The stream without a resource so the operation is not possible');
+		}
+
+		if (!$this->isReadable()) {
+			throw new RuntimeException('Stream is not readable');
+		}
+
+		$result = stream_get_contents($this->resource);
+		if ($result === false) {
+			throw new RuntimeException('Unable to read the remainder of the stream');
+		}
+
+		return $result;
+	}
+
+	/**
+	 * Gets the stream metadata
+	 *
+	 * @link http://php.net/manual/en/function.stream-get-meta-data.php
+	 *
+	 * @param string|null $key
+	 *
+	 * @return mixed
+	 */
+	public function getMetadata($key = null)
+	{
+		if (!is_resource($this->resource)) {
+			return null;
+		}
+
+		$metadata = stream_get_meta_data($this->resource);
+		if ($key === null) {
+			return $metadata;
+		}
+
+		return $metadata[$key] ?? null;
+	}
+
+	/**
+	 * Gets the stream size
+	 *
+	 * Returns NULL if the stream without a resource,
+	 * or if the stream size cannot be determined.
+	 *
+	 * @link http://php.net/manual/en/function.fstat.php
+	 *
+	 * @return int|null
+	 */
+	public function getSize(): ?int
+	{
+		if (!is_resource($this->resource)) {
+			return null;
+		}
+
+		/** @var array{size: int}|false */
+		$stats = fstat($this->resource);
+		if ($stats === false) {
+			return null;
+		}
+
+		return $stats['size'];
+	}
+
+	/**
+	 * Converts the stream to a string
+	 *
+	 * @link http://php.net/manual/en/language.oop5.magic.php#object.tostring
+	 *
+	 * @return string
+	 */
+	public function __toString(): string
+	{
+		if (!$this->isReadable()) {
+			return '';
+		}
+
+		try {
+			if ($this->isSeekable()) {
+				$this->rewind();
+			}
+
+			return $this->getContents();
+		} catch (Throwable $e) {
+			return '';
+		}
+	}
 }