sunrise-php / http-message

src/Uri/Component/User.php

Indentation +63 added lines, -63 removed lines

@@ -31,74 +31,74 @@
 final class User implements ComponentInterface
 {
 
-    /**
-     * Regular expression used for the component normalization
-     *
-     * @var string
-     */
-    // phpcs:ignore Generic.Files.LineLength
-    private const NORMALIZATION_REGEX = '/(?:%[0-9A-Fa-f]{2}|[\x21\x24\x26-\x2e\x30-\x39\x3b\x3d\x41-\x5a\x5f\x61-\x7a\x7e]+)|(.?)/u';
+	/**
+	 * Regular expression used for the component normalization
+	 *
+	 * @var string
+	 */
+	// phpcs:ignore Generic.Files.LineLength
+	private const NORMALIZATION_REGEX = '/(?:%[0-9A-Fa-f]{2}|[\x21\x24\x26-\x2e\x30-\x39\x3b\x3d\x41-\x5a\x5f\x61-\x7a\x7e]+)|(.?)/u';
 
-    /**
-     * The component value
-     *
-     * @var string
-     */
-    private string $value = '';
+	/**
+	 * The component value
+	 *
+	 * @var string
+	 */
+	private string $value = '';
 
-    /**
-     * Constructor of the class
-     *
-     * @param mixed $value
-     *
-     * @throws InvalidArgumentException
-     *         If the component isn't valid.
-     */
-    public function __construct($value)
-    {
-        if ($value === '') {
-            return;
-        }
+	/**
+	 * Constructor of the class
+	 *
+	 * @param mixed $value
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the component isn't valid.
+	 */
+	public function __construct($value)
+	{
+		if ($value === '') {
+			return;
+		}
 
-        if (!is_string($value)) {
-            throw new InvalidArgumentException('URI component "user" must be a string');
-        }
+		if (!is_string($value)) {
+			throw new InvalidArgumentException('URI component "user" must be a string');
+		}
 
-        $this->value = (string) preg_replace_callback(
-            self::NORMALIZATION_REGEX,
-            static function (array $match): string {
-                /** @var array{0: string, 1?: string} $match */
-                return isset($match[1]) ? rawurlencode($match[1]) : $match[0];
-            },
-            $value
-        );
-    }
+		$this->value = (string) preg_replace_callback(
+			self::NORMALIZATION_REGEX,
+			static function (array $match): string {
+				/** @var array{0: string, 1?: string} $match */
+				return isset($match[1]) ? rawurlencode($match[1]) : $match[0];
+			},
+			$value
+		);
+	}
 
-    /**
-     * Creates a user component
-     *
-     * @param mixed $user
-     *
-     * @return User
-     *
-     * @throws InvalidArgumentException
-     */
-    public static function create($user): User
-    {
-        if ($user instanceof User) {
-            return $user;
-        }
+	/**
+	 * Creates a user component
+	 *
+	 * @param mixed $user
+	 *
+	 * @return User
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public static function create($user): User
+	{
+		if ($user instanceof User) {
+			return $user;
+		}
 
-        return new User($user);
-    }
+		return new User($user);
+	}
 
-    /**
-     * {@inheritdoc}
-     *
-     * @return string
-     */
-    public function getValue(): string
-    {
-        return $this->value;
-    }
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return string
+	 */
+	public function getValue(): string
+	{
+		return $this->value;
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -66,7 +66,7 @@
 
         $this->value = (string) preg_replace_callback(
             self::NORMALIZATION_REGEX,
-            static function (array $match): string {
+            static function(array $match): string {
                 /** @var array{0: string, 1?: string} $match */
                 return isset($match[1]) ? rawurlencode($match[1]) : $match[0];
             },

src/Stream/FileStream.php

Indentation +22 added lines, -22 removed lines

@@ -30,26 +30,26 @@
 final class FileStream extends Stream
 {
 
-    /**
-     * Constructor of the class
-     *
-     * @param string $filename
-     * @param string $mode
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct(string $filename, string $mode)
-    {
-        $resource = @fopen($filename, $mode);
-
-        if (!is_resource($resource)) {
-            throw new InvalidArgumentException(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 InvalidArgumentException
+	 */
+	public function __construct(string $filename, string $mode)
+	{
+		$resource = @fopen($filename, $mode);
+
+		if (!is_resource($resource)) {
+			throw new InvalidArgumentException(sprintf(
+				'Unable to open the file "%s" in the mode "%s"',
+				$filename,
+				$mode
+			));
+		}
+
+		parent::__construct($resource);
+	}
 }

src/Stream/PhpInputStream.php

Indentation +13 added lines, -13 removed lines

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

src/Uri.php

Indentation +474 added lines, -474 removed lines

@@ -41,478 +41,478 @@
 class Uri implements UriInterface
 {
 
-    /**
-     * Scheme of the URI
-     *
-     * @var string
-     */
-    private string $scheme = '';
-
-    /**
-     * User Information of the URI
-     *
-     * @var string
-     */
-    private string $userInfo = '';
-
-    /**
-     * Host of the URI
-     *
-     * @var string
-     */
-    private string $host = '';
-
-    /**
-     * Port of the URI
-     *
-     * @var int|null
-     */
-    private ?int $port = null;
-
-    /**
-     * Path of the URI
-     *
-     * @var string
-     */
-    private string $path = '';
-
-    /**
-     * Query of the URI
-     *
-     * @var string
-     */
-    private string $query = '';
-
-    /**
-     * Fragment of the URI
-     *
-     * @var string
-     */
-    private string $fragment = '';
-
-    /**
-     * Constructor of the class
-     *
-     * @param string $uri
-     *
-     * @throws InvalidArgumentException
-     *         If the URI isn't valid.
-     */
-    public function __construct(string $uri = '')
-    {
-        if ($uri === '') {
-            return;
-        }
-
-        $components = parse_url($uri);
-        if ($components === false) {
-            throw new InvalidArgumentException('Invalid URI');
-        }
-
-        if (isset($components['scheme'])) {
-            $this->setScheme($components['scheme']);
-        }
-
-        if (isset($components['user'])) {
-            $this->setUserInfo(
-                $components['user'],
-                $components['pass'] ?? null
-            );
-        }
-
-        if (isset($components['host'])) {
-            $this->setHost($components['host']);
-        }
-
-        if (isset($components['port'])) {
-            $this->setPort($components['port']);
-        }
-
-        if (isset($components['path'])) {
-            $this->setPath($components['path']);
-        }
-
-        if (isset($components['query'])) {
-            $this->setQuery($components['query']);
-        }
-
-        if (isset($components['fragment'])) {
-            $this->setFragment($components['fragment']);
-        }
-    }
-
-    /**
-     * Creates a URI
-     *
-     * @param mixed $uri
-     *
-     * @return UriInterface
-     *
-     * @throws InvalidArgumentException
-     *         If the URI isn't valid.
-     */
-    public static function create($uri): UriInterface
-    {
-        if ($uri instanceof UriInterface) {
-            return $uri;
-        }
-
-        if (!is_string($uri)) {
-            throw new InvalidArgumentException('URI should be a string');
-        }
-
-        return new self($uri);
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @throws InvalidArgumentException
-     *         If the scheme isn't valid.
-     */
-    public function withScheme($scheme): UriInterface
-    {
-        $clone = clone $this;
-        $clone->setScheme($scheme);
-
-        return $clone;
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @throws InvalidArgumentException
-     *         If the user information isn't valid.
-     */
-    public function withUserInfo($user, $password = null): UriInterface
-    {
-        $clone = clone $this;
-        $clone->setUserInfo($user, $password);
-
-        return $clone;
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @throws InvalidArgumentException
-     *         If the host isn't valid.
-     */
-    public function withHost($host): UriInterface
-    {
-        $clone = clone $this;
-        $clone->setHost($host);
-
-        return $clone;
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @throws InvalidArgumentException
-     *         If the port isn't valid.
-     */
-    public function withPort($port): UriInterface
-    {
-        $clone = clone $this;
-        $clone->setPort($port);
-
-        return $clone;
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @throws InvalidArgumentException
-     *         If the path isn't valid.
-     */
-    public function withPath($path): UriInterface
-    {
-        $clone = clone $this;
-        $clone->setPath($path);
-
-        return $clone;
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @throws InvalidArgumentException
-     *         If the query isn't valid.
-     */
-    public function withQuery($query): UriInterface
-    {
-        $clone = clone $this;
-        $clone->setQuery($query);
-
-        return $clone;
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @throws InvalidArgumentException
-     *         If the fragment isn't valid.
-     */
-    public function withFragment($fragment): UriInterface
-    {
-        $clone = clone $this;
-        $clone->setFragment($fragment);
-
-        return $clone;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getScheme(): string
-    {
-        return $this->scheme;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getUserInfo(): string
-    {
-        return $this->userInfo;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getHost(): string
-    {
-        return $this->host;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getPort(): ?int
-    {
-        // The 80 is the default port number for the HTTP protocol.
-        if ($this->port === 80 && $this->scheme === 'http') {
-            return null;
-        }
-
-        // The 443 is the default port number for the HTTPS protocol.
-        if ($this->port === 443 && $this->scheme === 'https') {
-            return null;
-        }
-
-        return $this->port;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getPath(): string
-    {
-        // CVE-2015-3257
-        if (strncmp($this->path, '//', 2) === 0) {
-            return '/' . ltrim($this->path, '/');
-        }
-
-        return $this->path;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getQuery(): string
-    {
-        return $this->query;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getFragment(): string
-    {
-        return $this->fragment;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getAuthority(): string
-    {
-        // The host is the basic subcomponent.
-        if ($this->host === '') {
-            return '';
-        }
-
-        $authority = $this->host;
-        if ($this->userInfo !== '') {
-            $authority = $this->userInfo . '@' . $authority;
-        }
-
-        $port = $this->getPort();
-        if ($port !== null) {
-            $authority = $authority . ':' . $port;
-        }
-
-        return $authority;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function __toString(): string
-    {
-        $uri = '';
-
-        $scheme = $this->scheme;
-        if ($scheme !== '') {
-            $uri .= $scheme . ':';
-        }
-
-        $authority = $this->getAuthority();
-        if ($authority !== '') {
-            $uri .= '//' . $authority;
-        }
-
-        $path = $this->path;
-        if ($path !== '') {
-            // https://github.com/sunrise-php/uri/issues/31
-            // https://datatracker.ietf.org/doc/html/rfc3986#section-3.3
-            //
-            // If a URI contains an authority component,
-            // then the path component must either be empty
-            // or begin with a slash ("/") character.
-            if ($authority !== '' && strncmp($path, '/', 1) !== 0) {
-                $path = '/' . $path;
-            }
-
-            // https://github.com/sunrise-php/uri/issues/31
-            // https://datatracker.ietf.org/doc/html/rfc3986#section-3.3
-            //
-            // If a URI does not contain an authority component,
-            // then the path cannot begin with two slash characters ("//").
-            if ($authority === '' && strncmp($path, '//', 2) === 0) {
-                $path = '/' . ltrim($path, '/');
-            }
-
-            $uri .= $path;
-        }
-
-        $query = $this->query;
-        if ($query !== '') {
-            $uri .= '?' . $query;
-        }
-
-        $fragment = $this->fragment;
-        if ($fragment !== '') {
-            $uri .= '#' . $fragment;
-        }
-
-        return $uri;
-    }
-
-    /**
-     * Sets the given scheme to the URI
-     *
-     * @param mixed $scheme
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the scheme isn't valid.
-     */
-    final protected function setScheme($scheme): void
-    {
-        $this->scheme = (new Scheme($scheme))->getValue();
-    }
-
-    /**
-     * Sets the given user information to the URI
-     *
-     * @param mixed $user
-     * @param mixed $password
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the user information isn't valid.
-     */
-    final protected function setUserInfo($user, $password): void
-    {
-        $this->userInfo = (new UserInfo($user, $password))->getValue();
-    }
-
-    /**
-     * Sets the given host to the URI
-     *
-     * @param mixed $host
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the host isn't valid.
-     */
-    final protected function setHost($host): void
-    {
-        $this->host = (new Host($host))->getValue();
-    }
-
-    /**
-     * Sets the given port to the URI
-     *
-     * @param mixed $port
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the port isn't valid.
-     */
-    final protected function setPort($port): void
-    {
-        $this->port = (new Port($port))->getValue();
-    }
-
-    /**
-     * Sets the given path to the URI
-     *
-     * @param mixed $path
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the path isn't valid.
-     */
-    final protected function setPath($path): void
-    {
-        $this->path = (new Path($path))->getValue();
-    }
-
-    /**
-     * Sets the given query to the URI
-     *
-     * @param mixed $query
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the query isn't valid.
-     */
-    final protected function setQuery($query): void
-    {
-        $this->query = (new Query($query))->getValue();
-    }
-
-    /**
-     * Sets the given fragment to the URI
-     *
-     * @param mixed $fragment
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the fragment isn't valid.
-     */
-    final protected function setFragment($fragment): void
-    {
-        $this->fragment = (new Fragment($fragment))->getValue();
-    }
+	/**
+	 * Scheme of the URI
+	 *
+	 * @var string
+	 */
+	private string $scheme = '';
+
+	/**
+	 * User Information of the URI
+	 *
+	 * @var string
+	 */
+	private string $userInfo = '';
+
+	/**
+	 * Host of the URI
+	 *
+	 * @var string
+	 */
+	private string $host = '';
+
+	/**
+	 * Port of the URI
+	 *
+	 * @var int|null
+	 */
+	private ?int $port = null;
+
+	/**
+	 * Path of the URI
+	 *
+	 * @var string
+	 */
+	private string $path = '';
+
+	/**
+	 * Query of the URI
+	 *
+	 * @var string
+	 */
+	private string $query = '';
+
+	/**
+	 * Fragment of the URI
+	 *
+	 * @var string
+	 */
+	private string $fragment = '';
+
+	/**
+	 * Constructor of the class
+	 *
+	 * @param string $uri
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the URI isn't valid.
+	 */
+	public function __construct(string $uri = '')
+	{
+		if ($uri === '') {
+			return;
+		}
+
+		$components = parse_url($uri);
+		if ($components === false) {
+			throw new InvalidArgumentException('Invalid URI');
+		}
+
+		if (isset($components['scheme'])) {
+			$this->setScheme($components['scheme']);
+		}
+
+		if (isset($components['user'])) {
+			$this->setUserInfo(
+				$components['user'],
+				$components['pass'] ?? null
+			);
+		}
+
+		if (isset($components['host'])) {
+			$this->setHost($components['host']);
+		}
+
+		if (isset($components['port'])) {
+			$this->setPort($components['port']);
+		}
+
+		if (isset($components['path'])) {
+			$this->setPath($components['path']);
+		}
+
+		if (isset($components['query'])) {
+			$this->setQuery($components['query']);
+		}
+
+		if (isset($components['fragment'])) {
+			$this->setFragment($components['fragment']);
+		}
+	}
+
+	/**
+	 * Creates a URI
+	 *
+	 * @param mixed $uri
+	 *
+	 * @return UriInterface
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the URI isn't valid.
+	 */
+	public static function create($uri): UriInterface
+	{
+		if ($uri instanceof UriInterface) {
+			return $uri;
+		}
+
+		if (!is_string($uri)) {
+			throw new InvalidArgumentException('URI should be a string');
+		}
+
+		return new self($uri);
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the scheme isn't valid.
+	 */
+	public function withScheme($scheme): UriInterface
+	{
+		$clone = clone $this;
+		$clone->setScheme($scheme);
+
+		return $clone;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the user information isn't valid.
+	 */
+	public function withUserInfo($user, $password = null): UriInterface
+	{
+		$clone = clone $this;
+		$clone->setUserInfo($user, $password);
+
+		return $clone;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the host isn't valid.
+	 */
+	public function withHost($host): UriInterface
+	{
+		$clone = clone $this;
+		$clone->setHost($host);
+
+		return $clone;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the port isn't valid.
+	 */
+	public function withPort($port): UriInterface
+	{
+		$clone = clone $this;
+		$clone->setPort($port);
+
+		return $clone;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the path isn't valid.
+	 */
+	public function withPath($path): UriInterface
+	{
+		$clone = clone $this;
+		$clone->setPath($path);
+
+		return $clone;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the query isn't valid.
+	 */
+	public function withQuery($query): UriInterface
+	{
+		$clone = clone $this;
+		$clone->setQuery($query);
+
+		return $clone;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the fragment isn't valid.
+	 */
+	public function withFragment($fragment): UriInterface
+	{
+		$clone = clone $this;
+		$clone->setFragment($fragment);
+
+		return $clone;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getScheme(): string
+	{
+		return $this->scheme;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getUserInfo(): string
+	{
+		return $this->userInfo;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getHost(): string
+	{
+		return $this->host;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getPort(): ?int
+	{
+		// The 80 is the default port number for the HTTP protocol.
+		if ($this->port === 80 && $this->scheme === 'http') {
+			return null;
+		}
+
+		// The 443 is the default port number for the HTTPS protocol.
+		if ($this->port === 443 && $this->scheme === 'https') {
+			return null;
+		}
+
+		return $this->port;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getPath(): string
+	{
+		// CVE-2015-3257
+		if (strncmp($this->path, '//', 2) === 0) {
+			return '/' . ltrim($this->path, '/');
+		}
+
+		return $this->path;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getQuery(): string
+	{
+		return $this->query;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getFragment(): string
+	{
+		return $this->fragment;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getAuthority(): string
+	{
+		// The host is the basic subcomponent.
+		if ($this->host === '') {
+			return '';
+		}
+
+		$authority = $this->host;
+		if ($this->userInfo !== '') {
+			$authority = $this->userInfo . '@' . $authority;
+		}
+
+		$port = $this->getPort();
+		if ($port !== null) {
+			$authority = $authority . ':' . $port;
+		}
+
+		return $authority;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function __toString(): string
+	{
+		$uri = '';
+
+		$scheme = $this->scheme;
+		if ($scheme !== '') {
+			$uri .= $scheme . ':';
+		}
+
+		$authority = $this->getAuthority();
+		if ($authority !== '') {
+			$uri .= '//' . $authority;
+		}
+
+		$path = $this->path;
+		if ($path !== '') {
+			// https://github.com/sunrise-php/uri/issues/31
+			// https://datatracker.ietf.org/doc/html/rfc3986#section-3.3
+			//
+			// If a URI contains an authority component,
+			// then the path component must either be empty
+			// or begin with a slash ("/") character.
+			if ($authority !== '' && strncmp($path, '/', 1) !== 0) {
+				$path = '/' . $path;
+			}
+
+			// https://github.com/sunrise-php/uri/issues/31
+			// https://datatracker.ietf.org/doc/html/rfc3986#section-3.3
+			//
+			// If a URI does not contain an authority component,
+			// then the path cannot begin with two slash characters ("//").
+			if ($authority === '' && strncmp($path, '//', 2) === 0) {
+				$path = '/' . ltrim($path, '/');
+			}
+
+			$uri .= $path;
+		}
+
+		$query = $this->query;
+		if ($query !== '') {
+			$uri .= '?' . $query;
+		}
+
+		$fragment = $this->fragment;
+		if ($fragment !== '') {
+			$uri .= '#' . $fragment;
+		}
+
+		return $uri;
+	}
+
+	/**
+	 * Sets the given scheme to the URI
+	 *
+	 * @param mixed $scheme
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the scheme isn't valid.
+	 */
+	final protected function setScheme($scheme): void
+	{
+		$this->scheme = (new Scheme($scheme))->getValue();
+	}
+
+	/**
+	 * Sets the given user information to the URI
+	 *
+	 * @param mixed $user
+	 * @param mixed $password
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the user information isn't valid.
+	 */
+	final protected function setUserInfo($user, $password): void
+	{
+		$this->userInfo = (new UserInfo($user, $password))->getValue();
+	}
+
+	/**
+	 * Sets the given host to the URI
+	 *
+	 * @param mixed $host
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the host isn't valid.
+	 */
+	final protected function setHost($host): void
+	{
+		$this->host = (new Host($host))->getValue();
+	}
+
+	/**
+	 * Sets the given port to the URI
+	 *
+	 * @param mixed $port
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the port isn't valid.
+	 */
+	final protected function setPort($port): void
+	{
+		$this->port = (new Port($port))->getValue();
+	}
+
+	/**
+	 * Sets the given path to the URI
+	 *
+	 * @param mixed $path
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the path isn't valid.
+	 */
+	final protected function setPath($path): void
+	{
+		$this->path = (new Path($path))->getValue();
+	}
+
+	/**
+	 * Sets the given query to the URI
+	 *
+	 * @param mixed $query
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the query isn't valid.
+	 */
+	final protected function setQuery($query): void
+	{
+		$this->query = (new Query($query))->getValue();
+	}
+
+	/**
+	 * Sets the given fragment to the URI
+	 *
+	 * @param mixed $fragment
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the fragment isn't valid.
+	 */
+	final protected function setFragment($fragment): void
+	{
+		$this->fragment = (new Fragment($fragment))->getValue();
+	}
 }

src/Stream.php

Indentation +384 added lines, -384 removed lines

@@ -47,388 +47,388 @@
 class Stream implements StreamInterface
 {
 
-    /**
-     * The stream resource
-     *
-     * @var resource|null
-     */
-    private $resource;
-
-    /**
-     * Signals to close the stream on destruction
-     *
-     * @var bool
-     */
-    private bool $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('Stream has no resource');
-        }
-
-        $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('Stream has no resource');
-        }
-
-        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('Stream has no resource');
-        }
-
-        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
-     * @psalm-param int $length
-     * @phpstan-param int<0, max> $length
-     *
-     * @return string
-     *
-     * @throws RuntimeException
-     */
-    public function read($length): string
-    {
-        if (!is_resource($this->resource)) {
-            throw new RuntimeException('Stream has no resource');
-        }
-
-        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('Stream has no resource');
-        }
-
-        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 doesn't have 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 bool $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('Stream has no resource');
+		}
+
+		$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('Stream has no resource');
+		}
+
+		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('Stream has no resource');
+		}
+
+		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
+	 * @psalm-param int $length
+	 * @phpstan-param int<0, max> $length
+	 *
+	 * @return string
+	 *
+	 * @throws RuntimeException
+	 */
+	public function read($length): string
+	{
+		if (!is_resource($this->resource)) {
+			throw new RuntimeException('Stream has no resource');
+		}
+
+		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('Stream has no resource');
+		}
+
+		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 doesn't have 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 '';
+		}
+	}
 }

src/UploadedFile.php

Indentation +226 added lines, -226 removed lines

@@ -50,230 +50,230 @@
 class UploadedFile implements UploadedFileInterface
 {
 
-    /**
-     * List of upload errors
-     *
-     * @link https://www.php.net/manual/en/features.file-upload.errors.php
-     *
-     * @var array<int, non-empty-string>
-     */
-    public const UPLOAD_ERRORS = [
-        UPLOAD_ERR_OK         => 'No error',
-        UPLOAD_ERR_INI_SIZE   => 'Uploaded file exceeds the upload_max_filesize directive in the php.ini',
-        UPLOAD_ERR_FORM_SIZE  => 'Uploaded file exceeds the MAX_FILE_SIZE directive in the HTML form',
-        UPLOAD_ERR_PARTIAL    => 'Uploaded file was only partially uploaded',
-        UPLOAD_ERR_NO_FILE    => 'No file was uploaded',
-        UPLOAD_ERR_NO_TMP_DIR => 'Missing temporary directory',
-        UPLOAD_ERR_CANT_WRITE => 'Failed to write file to disk',
-        UPLOAD_ERR_EXTENSION  => 'File upload was stopped by a PHP extension',
-    ];
-
-    /**
-     * The file stream
-     *
-     * @var StreamInterface|null
-     */
-    private ?StreamInterface $stream = null;
-
-    /**
-     * The file size
-     *
-     * @var int|null
-     */
-    private ?int $size;
-
-    /**
-     * The file's error code
-     *
-     * @var int
-     */
-    private int $errorCode;
-
-    /**
-     * The file's error message
-     *
-     * @var string
-     */
-    private string $errorMessage;
-
-    /**
-     * The client's file name
-     *
-     * @var string|null
-     */
-    private ?string $clientFilename;
-
-    /**
-     * The client's file media type
-     *
-     * @var string|null
-     */
-    private ?string $clientMediaType;
-
-    /**
-     * Constructor of the class
-     *
-     * @param StreamInterface|null $stream
-     * @param int|null $size
-     * @param int $error
-     * @param string|null $clientFilename
-     * @param string|null $clientMediaType
-     */
-    public function __construct(
-        ?StreamInterface $stream,
-        ?int $size = null,
-        int $error = UPLOAD_ERR_OK,
-        ?string $clientFilename = null,
-        ?string $clientMediaType = null
-    ) {
-        // It doesn't make sense to keep the stream
-        // if the file wasn't successfully uploaded...
-        if (UPLOAD_ERR_OK === $error) {
-            $this->stream = $stream;
-        }
-
-        $this->size = $size;
-        $this->errorCode = $error;
-        $this->errorMessage = self::UPLOAD_ERRORS[$error] ?? 'Unknown error';
-        $this->clientFilename = $clientFilename;
-        $this->clientMediaType = $clientMediaType;
-    }
-
-    /**
-     * Gets the file stream
-     *
-     * @return StreamInterface
-     *
-     * @throws RuntimeException
-     *         - If the file has no a stream due to an error;
-     *         - If the file was already moved.
-     */
-    public function getStream(): StreamInterface
-    {
-        if (UPLOAD_ERR_OK <> $this->errorCode) {
-            throw new RuntimeException(sprintf(
-                'Uploaded file has no a stream due to the error #%d (%s)',
-                $this->errorCode,
-                $this->errorMessage
-            ));
-        }
-
-        if (!isset($this->stream)) {
-            throw new RuntimeException(
-                'Uploaded file has no a stream because it was already moved'
-            );
-        }
-
-        return $this->stream;
-    }
-
-    /**
-     * Moves the file to the given path
-     *
-     * @param string $targetPath
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the target path cannot be used.
-     *
-     * @throws RuntimeException
-     *         - If the file has no a stream due to an error;
-     *         - If the file was already moved;
-     *         - If the file cannot be read.
-     */
-    public function moveTo($targetPath): void
-    {
-        if (UPLOAD_ERR_OK <> $this->errorCode) {
-            throw new RuntimeException(sprintf(
-                'Uploaded file cannot be moved due to the error #%d (%s)',
-                $this->errorCode,
-                $this->errorMessage
-            ));
-        }
-
-        if (!isset($this->stream)) {
-            throw new RuntimeException(
-                'Uploaded file cannot be moved because it was already moved'
-            );
-        }
-
-        if (!$this->stream->isReadable()) {
-            throw new RuntimeException(
-                'Uploaded file cannot be moved because it is not readable'
-            );
-        }
-
-        try {
-            $targetStream = new FileStream($targetPath, 'wb');
-        } catch (InvalidArgumentException $e) {
-            throw new InvalidArgumentException(sprintf(
-                'Uploaded file cannot be moved due to the error: %s',
-                $e->getMessage()
-            ));
-        }
-
-        if ($this->stream->isSeekable()) {
-            $this->stream->rewind();
-        }
-
-        while (!$this->stream->eof()) {
-            $targetStream->write($this->stream->read(4096));
-        }
-
-        $targetStream->close();
-
-        /** @var string|null */
-        $sourcePath = $this->stream->getMetadata('uri');
-
-        $this->stream->close();
-        $this->stream = null;
-
-        if (isset($sourcePath) && is_file($sourcePath)) {
-            $sourceDir = dirname($sourcePath);
-            if (is_writable($sourceDir)) {
-                unlink($sourcePath);
-            }
-        }
-    }
-
-    /**
-     * Gets the file size
-     *
-     * @return int|null
-     */
-    public function getSize(): ?int
-    {
-        return $this->size;
-    }
-
-    /**
-     * Gets the file's error code
-     *
-     * @return int
-     */
-    public function getError(): int
-    {
-        return $this->errorCode;
-    }
-
-    /**
-     * Gets the client's file name
-     *
-     * @return string|null
-     */
-    public function getClientFilename(): ?string
-    {
-        return $this->clientFilename;
-    }
-
-    /**
-     * Gets the client's file media type
-     *
-     * @return string|null
-     */
-    public function getClientMediaType(): ?string
-    {
-        return $this->clientMediaType;
-    }
+	/**
+	 * List of upload errors
+	 *
+	 * @link https://www.php.net/manual/en/features.file-upload.errors.php
+	 *
+	 * @var array<int, non-empty-string>
+	 */
+	public const UPLOAD_ERRORS = [
+		UPLOAD_ERR_OK         => 'No error',
+		UPLOAD_ERR_INI_SIZE   => 'Uploaded file exceeds the upload_max_filesize directive in the php.ini',
+		UPLOAD_ERR_FORM_SIZE  => 'Uploaded file exceeds the MAX_FILE_SIZE directive in the HTML form',
+		UPLOAD_ERR_PARTIAL    => 'Uploaded file was only partially uploaded',
+		UPLOAD_ERR_NO_FILE    => 'No file was uploaded',
+		UPLOAD_ERR_NO_TMP_DIR => 'Missing temporary directory',
+		UPLOAD_ERR_CANT_WRITE => 'Failed to write file to disk',
+		UPLOAD_ERR_EXTENSION  => 'File upload was stopped by a PHP extension',
+	];
+
+	/**
+	 * The file stream
+	 *
+	 * @var StreamInterface|null
+	 */
+	private ?StreamInterface $stream = null;
+
+	/**
+	 * The file size
+	 *
+	 * @var int|null
+	 */
+	private ?int $size;
+
+	/**
+	 * The file's error code
+	 *
+	 * @var int
+	 */
+	private int $errorCode;
+
+	/**
+	 * The file's error message
+	 *
+	 * @var string
+	 */
+	private string $errorMessage;
+
+	/**
+	 * The client's file name
+	 *
+	 * @var string|null
+	 */
+	private ?string $clientFilename;
+
+	/**
+	 * The client's file media type
+	 *
+	 * @var string|null
+	 */
+	private ?string $clientMediaType;
+
+	/**
+	 * Constructor of the class
+	 *
+	 * @param StreamInterface|null $stream
+	 * @param int|null $size
+	 * @param int $error
+	 * @param string|null $clientFilename
+	 * @param string|null $clientMediaType
+	 */
+	public function __construct(
+		?StreamInterface $stream,
+		?int $size = null,
+		int $error = UPLOAD_ERR_OK,
+		?string $clientFilename = null,
+		?string $clientMediaType = null
+	) {
+		// It doesn't make sense to keep the stream
+		// if the file wasn't successfully uploaded...
+		if (UPLOAD_ERR_OK === $error) {
+			$this->stream = $stream;
+		}
+
+		$this->size = $size;
+		$this->errorCode = $error;
+		$this->errorMessage = self::UPLOAD_ERRORS[$error] ?? 'Unknown error';
+		$this->clientFilename = $clientFilename;
+		$this->clientMediaType = $clientMediaType;
+	}
+
+	/**
+	 * Gets the file stream
+	 *
+	 * @return StreamInterface
+	 *
+	 * @throws RuntimeException
+	 *         - If the file has no a stream due to an error;
+	 *         - If the file was already moved.
+	 */
+	public function getStream(): StreamInterface
+	{
+		if (UPLOAD_ERR_OK <> $this->errorCode) {
+			throw new RuntimeException(sprintf(
+				'Uploaded file has no a stream due to the error #%d (%s)',
+				$this->errorCode,
+				$this->errorMessage
+			));
+		}
+
+		if (!isset($this->stream)) {
+			throw new RuntimeException(
+				'Uploaded file has no a stream because it was already moved'
+			);
+		}
+
+		return $this->stream;
+	}
+
+	/**
+	 * Moves the file to the given path
+	 *
+	 * @param string $targetPath
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the target path cannot be used.
+	 *
+	 * @throws RuntimeException
+	 *         - If the file has no a stream due to an error;
+	 *         - If the file was already moved;
+	 *         - If the file cannot be read.
+	 */
+	public function moveTo($targetPath): void
+	{
+		if (UPLOAD_ERR_OK <> $this->errorCode) {
+			throw new RuntimeException(sprintf(
+				'Uploaded file cannot be moved due to the error #%d (%s)',
+				$this->errorCode,
+				$this->errorMessage
+			));
+		}
+
+		if (!isset($this->stream)) {
+			throw new RuntimeException(
+				'Uploaded file cannot be moved because it was already moved'
+			);
+		}
+
+		if (!$this->stream->isReadable()) {
+			throw new RuntimeException(
+				'Uploaded file cannot be moved because it is not readable'
+			);
+		}
+
+		try {
+			$targetStream = new FileStream($targetPath, 'wb');
+		} catch (InvalidArgumentException $e) {
+			throw new InvalidArgumentException(sprintf(
+				'Uploaded file cannot be moved due to the error: %s',
+				$e->getMessage()
+			));
+		}
+
+		if ($this->stream->isSeekable()) {
+			$this->stream->rewind();
+		}
+
+		while (!$this->stream->eof()) {
+			$targetStream->write($this->stream->read(4096));
+		}
+
+		$targetStream->close();
+
+		/** @var string|null */
+		$sourcePath = $this->stream->getMetadata('uri');
+
+		$this->stream->close();
+		$this->stream = null;
+
+		if (isset($sourcePath) && is_file($sourcePath)) {
+			$sourceDir = dirname($sourcePath);
+			if (is_writable($sourceDir)) {
+				unlink($sourcePath);
+			}
+		}
+	}
+
+	/**
+	 * Gets the file size
+	 *
+	 * @return int|null
+	 */
+	public function getSize(): ?int
+	{
+		return $this->size;
+	}
+
+	/**
+	 * Gets the file's error code
+	 *
+	 * @return int
+	 */
+	public function getError(): int
+	{
+		return $this->errorCode;
+	}
+
+	/**
+	 * Gets the client's file name
+	 *
+	 * @return string|null
+	 */
+	public function getClientFilename(): ?string
+	{
+		return $this->clientFilename;
+	}
+
+	/**
+	 * Gets the client's file media type
+	 *
+	 * @return string|null
+	 */
+	public function getClientMediaType(): ?string
+	{
+		return $this->clientMediaType;
+	}
 }

src/Message.php

Indentation +390 added lines, -390 removed lines

@@ -39,394 +39,394 @@
 abstract class Message implements MessageInterface
 {
 
-    /**
-     * Allowed HTTP versions
-     *
-     * @var list<string>
-     */
-    public const ALLOWED_HTTP_VERSIONS = ['1.0', '1.1', '2.0', '2'];
-
-    /**
-     * Default HTTP version
-     *
-     * @var string
-     */
-    public const DEFAULT_HTTP_VERSION = '1.1';
-
-    /**
-     * The message HTTP version
-     *
-     * @var string
-     */
-    private string $protocolVersion = self::DEFAULT_HTTP_VERSION;
-
-    /**
-     * The message headers
-     *
-     * @var array<string, list<string>>
-     */
-    private array $headers = [];
-
-    /**
-     * Original header names
-     *
-     * @var array<string, string>
-     */
-    private array $headerNames = [];
-
-    /**
-     * The message body
-     *
-     * @var StreamInterface|null
-     */
-    private ?StreamInterface $body = null;
-
-    /**
-     * Gets the message HTTP version
-     *
-     * @return string
-     */
-    public function getProtocolVersion(): string
-    {
-        return $this->protocolVersion;
-    }
-
-    /**
-     * Creates a new instance of the message with the given HTTP version
-     *
-     * @param string $version
-     *
-     * @return static
-     *
-     * @throws InvalidArgumentException
-     *         If the HTTP version isn't valid.
-     */
-    public function withProtocolVersion($version): MessageInterface
-    {
-        $clone = clone $this;
-        $clone->setProtocolVersion($version);
-
-        return $clone;
-    }
-
-    /**
-     * Gets the message headers
-     *
-     * @return array<string, list<string>>
-     */
-    public function getHeaders(): array
-    {
-        return $this->headers;
-    }
-
-    /**
-     * Checks if a header exists in the message by the given name
-     *
-     * @param string $name
-     *
-     * @return bool
-     */
-    public function hasHeader($name): bool
-    {
-        $key = strtolower($name);
-
-        return isset($this->headerNames[$key]);
-    }
-
-    /**
-     * Gets a header value(s) from the message by the given name
-     *
-     * @param string $name
-     *
-     * @return list<string>
-     */
-    public function getHeader($name): array
-    {
-        $key = strtolower($name);
-
-        if (!isset($this->headerNames[$key])) {
-            return [];
-        }
-
-        return $this->headers[$this->headerNames[$key]];
-    }
-
-    /**
-     * Gets a header value as a string from the message by the given name
-     *
-     * @param string $name
-     *
-     * @return string
-     */
-    public function getHeaderLine($name): string
-    {
-        $key = strtolower($name);
-
-        if (!isset($this->headerNames[$key])) {
-            return '';
-        }
-
-        return implode(',', $this->headers[$this->headerNames[$key]]);
-    }
-
-    /**
-     * Creates a new instance of the message with the given header overwriting the old header
-     *
-     * @param string $name
-     * @param string|string[] $value
-     *
-     * @return static
-     *
-     * @throws InvalidArgumentException
-     *         If the header isn't valid.
-     */
-    public function withHeader($name, $value): MessageInterface
-    {
-        $clone = clone $this;
-        $clone->setHeader($name, $value, true);
-
-        return $clone;
-    }
-
-    /**
-     * Creates a new instance of the message with the given header NOT overwriting the old header
-     *
-     * @param string $name
-     * @param string|string[] $value
-     *
-     * @return static
-     *
-     * @throws InvalidArgumentException
-     *         If the header isn't valid.
-     */
-    public function withAddedHeader($name, $value): MessageInterface
-    {
-        $clone = clone $this;
-        $clone->setHeader($name, $value, false);
-
-        return $clone;
-    }
-
-    /**
-     * Creates a new instance of the message without a header by the given name
-     *
-     * @param string $name
-     *
-     * @return static
-     */
-    public function withoutHeader($name): MessageInterface
-    {
-        $clone = clone $this;
-        $clone->deleteHeader($name);
-
-        return $clone;
-    }
-
-    /**
-     * Gets the message body
-     *
-     * @return StreamInterface
-     */
-    public function getBody(): StreamInterface
-    {
-        return $this->body ??= new PhpTempStream();
-    }
-
-    /**
-     * Creates a new instance of the message with the given body
-     *
-     * @param StreamInterface $body
-     *
-     * @return static
-     */
-    public function withBody(StreamInterface $body): MessageInterface
-    {
-        $clone = clone $this;
-        $clone->setBody($body);
-
-        return $clone;
-    }
-
-    /**
-     * Sets the given HTTP version to the message
-     *
-     * @param string $protocolVersion
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the HTTP version isn't valid.
-     */
-    final protected function setProtocolVersion($protocolVersion): void
-    {
-        $this->validateProtocolVersion($protocolVersion);
-
-        $this->protocolVersion = $protocolVersion;
-    }
-
-    /**
-     * Sets a new header to the message with the given name and value(s)
-     *
-     * @param string $name
-     * @param string|string[] $value
-     * @param bool $replace
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the header isn't valid.
-     */
-    final protected function setHeader($name, $value, bool $replace = true): void
-    {
-        if (!is_array($value)) {
-            $value = [$value];
-        }
-
-        $this->validateHeaderName($name);
-        $this->validateHeaderValue($name, $value);
-
-        if ($replace) {
-            $this->deleteHeader($name);
-        }
-
-        $key = strtolower($name);
-
-        $this->headerNames[$key] ??= $name;
-        $this->headers[$this->headerNames[$key]] ??= [];
-
-        foreach ($value as $item) {
-            $this->headers[$this->headerNames[$key]][] = $item;
-        }
-    }
-
-    /**
-     * Sets the given headers to the message
-     *
-     * @param array<string, string|string[]> $headers
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If one of the headers isn't valid.
-     */
-    final protected function setHeaders(array $headers): void
-    {
-        foreach ($headers as $name => $value) {
-            $this->setHeader($name, $value, false);
-        }
-    }
-
-    /**
-     * Deletes a header from the message by the given name
-     *
-     * @param string $name
-     *
-     * @return void
-     */
-    final protected function deleteHeader($name): void
-    {
-        $key = strtolower($name);
-
-        if (isset($this->headerNames[$key])) {
-            unset($this->headers[$this->headerNames[$key]]);
-            unset($this->headerNames[$key]);
-        }
-    }
-
-    /**
-     * Sets the given body to the message
-     *
-     * @param StreamInterface $body
-     *
-     * @return void
-     */
-    final protected function setBody(StreamInterface $body): void
-    {
-        $this->body = $body;
-    }
-
-    /**
-     * Validates the given HTTP version
-     *
-     * @param mixed $protocolVersion
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the HTTP version isn't valid.
-     */
-    private function validateProtocolVersion($protocolVersion): void
-    {
-        if (!in_array($protocolVersion, self::ALLOWED_HTTP_VERSIONS, true)) {
-            throw new InvalidArgumentException('Unallowed HTTP version');
-        }
-    }
-
-    /**
-     * Validates the given header name
-     *
-     * @param mixed $name
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the header name isn't valid.
-     */
-    private function validateHeaderName($name): void
-    {
-        if ($name === '') {
-            throw new InvalidArgumentException('HTTP header name cannot be an empty');
-        }
-
-        if (!is_string($name)) {
-            throw new InvalidArgumentException('HTTP header name must be a string');
-        }
-
-        if (!preg_match(HeaderInterface::RFC7230_TOKEN_REGEX, $name)) {
-            throw new InvalidArgumentException('HTTP header name is invalid');
-        }
-    }
-
-    /**
-     * Validates the given header value
-     *
-     * @param string $name
-     * @param array<array-key, mixed> $value
-     *
-     * @return void
-     *
-     * @throws InvalidArgumentException
-     *         If the header value isn't valid.
-     */
-    private function validateHeaderValue(string $name, array $value): void
-    {
-        if ([] === $value) {
-            throw new InvalidArgumentException(sprintf(
-                'The "%s" HTTP header value cannot be an empty array',
-                $name,
-            ));
-        }
-
-        foreach ($value as $key => $item) {
-            if ('' === $item) {
-                continue;
-            }
-
-            if (!is_string($item)) {
-                throw new InvalidArgumentException(sprintf(
-                    'The "%s[%s]" HTTP header value must be a string',
-                    $name,
-                    $key
-                ));
-            }
-
-            if (!preg_match(HeaderInterface::RFC7230_FIELD_VALUE_REGEX, $item)) {
-                throw new InvalidArgumentException(sprintf(
-                    'The "%s[%s]" HTTP header value is invalid',
-                    $name,
-                    $key
-                ));
-            }
-        }
-    }
+	/**
+	 * Allowed HTTP versions
+	 *
+	 * @var list<string>
+	 */
+	public const ALLOWED_HTTP_VERSIONS = ['1.0', '1.1', '2.0', '2'];
+
+	/**
+	 * Default HTTP version
+	 *
+	 * @var string
+	 */
+	public const DEFAULT_HTTP_VERSION = '1.1';
+
+	/**
+	 * The message HTTP version
+	 *
+	 * @var string
+	 */
+	private string $protocolVersion = self::DEFAULT_HTTP_VERSION;
+
+	/**
+	 * The message headers
+	 *
+	 * @var array<string, list<string>>
+	 */
+	private array $headers = [];
+
+	/**
+	 * Original header names
+	 *
+	 * @var array<string, string>
+	 */
+	private array $headerNames = [];
+
+	/**
+	 * The message body
+	 *
+	 * @var StreamInterface|null
+	 */
+	private ?StreamInterface $body = null;
+
+	/**
+	 * Gets the message HTTP version
+	 *
+	 * @return string
+	 */
+	public function getProtocolVersion(): string
+	{
+		return $this->protocolVersion;
+	}
+
+	/**
+	 * Creates a new instance of the message with the given HTTP version
+	 *
+	 * @param string $version
+	 *
+	 * @return static
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the HTTP version isn't valid.
+	 */
+	public function withProtocolVersion($version): MessageInterface
+	{
+		$clone = clone $this;
+		$clone->setProtocolVersion($version);
+
+		return $clone;
+	}
+
+	/**
+	 * Gets the message headers
+	 *
+	 * @return array<string, list<string>>
+	 */
+	public function getHeaders(): array
+	{
+		return $this->headers;
+	}
+
+	/**
+	 * Checks if a header exists in the message by the given name
+	 *
+	 * @param string $name
+	 *
+	 * @return bool
+	 */
+	public function hasHeader($name): bool
+	{
+		$key = strtolower($name);
+
+		return isset($this->headerNames[$key]);
+	}
+
+	/**
+	 * Gets a header value(s) from the message by the given name
+	 *
+	 * @param string $name
+	 *
+	 * @return list<string>
+	 */
+	public function getHeader($name): array
+	{
+		$key = strtolower($name);
+
+		if (!isset($this->headerNames[$key])) {
+			return [];
+		}
+
+		return $this->headers[$this->headerNames[$key]];
+	}
+
+	/**
+	 * Gets a header value as a string from the message by the given name
+	 *
+	 * @param string $name
+	 *
+	 * @return string
+	 */
+	public function getHeaderLine($name): string
+	{
+		$key = strtolower($name);
+
+		if (!isset($this->headerNames[$key])) {
+			return '';
+		}
+
+		return implode(',', $this->headers[$this->headerNames[$key]]);
+	}
+
+	/**
+	 * Creates a new instance of the message with the given header overwriting the old header
+	 *
+	 * @param string $name
+	 * @param string|string[] $value
+	 *
+	 * @return static
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the header isn't valid.
+	 */
+	public function withHeader($name, $value): MessageInterface
+	{
+		$clone = clone $this;
+		$clone->setHeader($name, $value, true);
+
+		return $clone;
+	}
+
+	/**
+	 * Creates a new instance of the message with the given header NOT overwriting the old header
+	 *
+	 * @param string $name
+	 * @param string|string[] $value
+	 *
+	 * @return static
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the header isn't valid.
+	 */
+	public function withAddedHeader($name, $value): MessageInterface
+	{
+		$clone = clone $this;
+		$clone->setHeader($name, $value, false);
+
+		return $clone;
+	}
+
+	/**
+	 * Creates a new instance of the message without a header by the given name
+	 *
+	 * @param string $name
+	 *
+	 * @return static
+	 */
+	public function withoutHeader($name): MessageInterface
+	{
+		$clone = clone $this;
+		$clone->deleteHeader($name);
+
+		return $clone;
+	}
+
+	/**
+	 * Gets the message body
+	 *
+	 * @return StreamInterface
+	 */
+	public function getBody(): StreamInterface
+	{
+		return $this->body ??= new PhpTempStream();
+	}
+
+	/**
+	 * Creates a new instance of the message with the given body
+	 *
+	 * @param StreamInterface $body
+	 *
+	 * @return static
+	 */
+	public function withBody(StreamInterface $body): MessageInterface
+	{
+		$clone = clone $this;
+		$clone->setBody($body);
+
+		return $clone;
+	}
+
+	/**
+	 * Sets the given HTTP version to the message
+	 *
+	 * @param string $protocolVersion
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the HTTP version isn't valid.
+	 */
+	final protected function setProtocolVersion($protocolVersion): void
+	{
+		$this->validateProtocolVersion($protocolVersion);
+
+		$this->protocolVersion = $protocolVersion;
+	}
+
+	/**
+	 * Sets a new header to the message with the given name and value(s)
+	 *
+	 * @param string $name
+	 * @param string|string[] $value
+	 * @param bool $replace
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the header isn't valid.
+	 */
+	final protected function setHeader($name, $value, bool $replace = true): void
+	{
+		if (!is_array($value)) {
+			$value = [$value];
+		}
+
+		$this->validateHeaderName($name);
+		$this->validateHeaderValue($name, $value);
+
+		if ($replace) {
+			$this->deleteHeader($name);
+		}
+
+		$key = strtolower($name);
+
+		$this->headerNames[$key] ??= $name;
+		$this->headers[$this->headerNames[$key]] ??= [];
+
+		foreach ($value as $item) {
+			$this->headers[$this->headerNames[$key]][] = $item;
+		}
+	}
+
+	/**
+	 * Sets the given headers to the message
+	 *
+	 * @param array<string, string|string[]> $headers
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If one of the headers isn't valid.
+	 */
+	final protected function setHeaders(array $headers): void
+	{
+		foreach ($headers as $name => $value) {
+			$this->setHeader($name, $value, false);
+		}
+	}
+
+	/**
+	 * Deletes a header from the message by the given name
+	 *
+	 * @param string $name
+	 *
+	 * @return void
+	 */
+	final protected function deleteHeader($name): void
+	{
+		$key = strtolower($name);
+
+		if (isset($this->headerNames[$key])) {
+			unset($this->headers[$this->headerNames[$key]]);
+			unset($this->headerNames[$key]);
+		}
+	}
+
+	/**
+	 * Sets the given body to the message
+	 *
+	 * @param StreamInterface $body
+	 *
+	 * @return void
+	 */
+	final protected function setBody(StreamInterface $body): void
+	{
+		$this->body = $body;
+	}
+
+	/**
+	 * Validates the given HTTP version
+	 *
+	 * @param mixed $protocolVersion
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the HTTP version isn't valid.
+	 */
+	private function validateProtocolVersion($protocolVersion): void
+	{
+		if (!in_array($protocolVersion, self::ALLOWED_HTTP_VERSIONS, true)) {
+			throw new InvalidArgumentException('Unallowed HTTP version');
+		}
+	}
+
+	/**
+	 * Validates the given header name
+	 *
+	 * @param mixed $name
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the header name isn't valid.
+	 */
+	private function validateHeaderName($name): void
+	{
+		if ($name === '') {
+			throw new InvalidArgumentException('HTTP header name cannot be an empty');
+		}
+
+		if (!is_string($name)) {
+			throw new InvalidArgumentException('HTTP header name must be a string');
+		}
+
+		if (!preg_match(HeaderInterface::RFC7230_TOKEN_REGEX, $name)) {
+			throw new InvalidArgumentException('HTTP header name is invalid');
+		}
+	}
+
+	/**
+	 * Validates the given header value
+	 *
+	 * @param string $name
+	 * @param array<array-key, mixed> $value
+	 *
+	 * @return void
+	 *
+	 * @throws InvalidArgumentException
+	 *         If the header value isn't valid.
+	 */
+	private function validateHeaderValue(string $name, array $value): void
+	{
+		if ([] === $value) {
+			throw new InvalidArgumentException(sprintf(
+				'The "%s" HTTP header value cannot be an empty array',
+				$name,
+			));
+		}
+
+		foreach ($value as $key => $item) {
+			if ('' === $item) {
+				continue;
+			}
+
+			if (!is_string($item)) {
+				throw new InvalidArgumentException(sprintf(
+					'The "%s[%s]" HTTP header value must be a string',
+					$name,
+					$key
+				));
+			}
+
+			if (!preg_match(HeaderInterface::RFC7230_FIELD_VALUE_REGEX, $item)) {
+				throw new InvalidArgumentException(sprintf(
+					'The "%s[%s]" HTTP header value is invalid',
+					$name,
+					$key
+				));
+			}
+		}
+	}
 }

functions/server_request_files.php

Indentation +35 added lines, -35 removed lines

@@ -45,45 +45,45 @@
  */
 function server_request_files(?array $files = null): array
 {
-    $files ??= $_FILES;
+	$files ??= $_FILES;
 
-    $walker = static function ($path, $size, $error, $name, $type) use (&$walker) {
-        if (!is_array($path)) {
-            // It makes no sense to create a stream
-            // if the file has not been successfully uploaded.
-            $stream = UPLOAD_ERR_OK <> $error ? null : new FileStream($path, 'rb');
+	$walker = static function ($path, $size, $error, $name, $type) use (&$walker) {
+		if (!is_array($path)) {
+			// It makes no sense to create a stream
+			// if the file has not been successfully uploaded.
+			$stream = UPLOAD_ERR_OK <> $error ? null : new FileStream($path, 'rb');
 
-            return new UploadedFile($stream, $size, $error, $name, $type);
-        }
+			return new UploadedFile($stream, $size, $error, $name, $type);
+		}
 
-        $result = [];
-        foreach ($path as $key => $_) {
-            if (UPLOAD_ERR_NO_FILE <> $error[$key]) {
-                $result[$key] = $walker(
-                    $path[$key],
-                    $size[$key],
-                    $error[$key],
-                    $name[$key],
-                    $type[$key]
-                );
-            }
-        }
+		$result = [];
+		foreach ($path as $key => $_) {
+			if (UPLOAD_ERR_NO_FILE <> $error[$key]) {
+				$result[$key] = $walker(
+					$path[$key],
+					$size[$key],
+					$error[$key],
+					$name[$key],
+					$type[$key]
+				);
+			}
+		}
 
-        return $result;
-    };
+		return $result;
+	};
 
-    $result = [];
-    foreach ($files as $key => $file) {
-        if (UPLOAD_ERR_NO_FILE <> $file['error']) {
-            $result[$key] = $walker(
-                $file['tmp_name'],
-                $file['size'],
-                $file['error'],
-                $file['name'],
-                $file['type']
-            );
-        }
-    }
+	$result = [];
+	foreach ($files as $key => $file) {
+		if (UPLOAD_ERR_NO_FILE <> $file['error']) {
+			$result[$key] = $walker(
+				$file['tmp_name'],
+				$file['size'],
+				$file['error'],
+				$file['name'],
+				$file['type']
+			);
+		}
+	}
 
-    return $result;
+	return $result;
 }

Spacing +1 added lines, -1 removed lines

@@ -47,7 +47,7 @@
 {
     $files ??= $_FILES;
 
-    $walker = static function ($path, $size, $error, $name, $type) use (&$walker) {
+    $walker = static function($path, $size, $error, $name, $type) use (&$walker) {
         if (!is_array($path)) {
             // It makes no sense to create a stream
             // if the file has not been successfully uploaded.