sunrise-php / http-message

src/Uri/Component/UserInfo.php

Indentation +33 added lines, -33 removed lines

@@ -18,37 +18,37 @@
  */
 final class UserInfo implements ComponentInterface
 {
-    private User $user;
-    private ?Password $password = null;
-
-    /**
-     * @param mixed $user
-     * @param mixed $password
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct($user, $password = null)
-    {
-        $this->user = User::create($user);
-
-        if ($password !== null) {
-            $this->password = Password::create($password);
-        }
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @return string
-     */
-    public function getValue(): string
-    {
-        $value = $this->user->getValue();
-
-        if ($this->password !== null) {
-            $value .= ':' . $this->password->getValue();
-        }
-
-        return $value;
-    }
+	private User $user;
+	private ?Password $password = null;
+
+	/**
+	 * @param mixed $user
+	 * @param mixed $password
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct($user, $password = null)
+	{
+		$this->user = User::create($user);
+
+		if ($password !== null) {
+			$this->password = Password::create($password);
+		}
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return string
+	 */
+	public function getValue(): string
+	{
+		$value = $this->user->getValue();
+
+		if ($this->password !== null) {
+			$value .= ':' . $this->password->getValue();
+		}
+
+		return $value;
+	}
 }

src/Uri/Component/User.php

Indentation +46 added lines, -46 removed lines

@@ -22,57 +22,57 @@
  */
 final class User implements ComponentInterface
 {
-    // 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';
+	// 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';
 
-    private string $value = '';
+	private string $value = '';
 
-    /**
-     * @param mixed $value
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct($value)
-    {
-        if ($value === '') {
-            return;
-        }
+	/**
+	 * @param mixed $value
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	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 fn(array $matches): string => (
-                /** @var array{0: string, 1?: string} $matches */
-                isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
-            ),
-            $value,
-        );
-    }
+		$this->value = (string) preg_replace_callback(
+			self::NORMALIZATION_REGEX,
+			static fn(array $matches): string => (
+				/** @var array{0: string, 1?: string} $matches */
+				isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
+			),
+			$value,
+		);
+	}
 
-    /**
-     * @param mixed $user
-     *
-     * @throws InvalidArgumentException
-     */
-    public static function create($user): User
-    {
-        if ($user instanceof User) {
-            return $user;
-        }
+	/**
+	 * @param mixed $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;
+	}
 }

src/Uri/Component/Password.php

Indentation +46 added lines, -46 removed lines

@@ -22,57 +22,57 @@
  */
 final class Password implements ComponentInterface
 {
-    // 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';
+	// 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';
 
-    private string $value = '';
+	private string $value = '';
 
-    /**
-     * @param mixed $value
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct($value)
-    {
-        if ($value === '') {
-            return;
-        }
+	/**
+	 * @param mixed $value
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct($value)
+	{
+		if ($value === '') {
+			return;
+		}
 
-        if (!is_string($value)) {
-            throw new InvalidArgumentException('URI component "password" must be a string');
-        }
+		if (!is_string($value)) {
+			throw new InvalidArgumentException('URI component "password" must be a string');
+		}
 
-        $this->value = (string) preg_replace_callback(
-            self::NORMALIZATION_REGEX,
-            static fn(array $matches): string => (
-                /** @var array{0: string, 1?: string} $matches */
-                isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
-            ),
-            $value,
-        );
-    }
+		$this->value = (string) preg_replace_callback(
+			self::NORMALIZATION_REGEX,
+			static fn(array $matches): string => (
+				/** @var array{0: string, 1?: string} $matches */
+				isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
+			),
+			$value,
+		);
+	}
 
-    /**
-     * @param mixed $password
-     *
-     * @throws InvalidArgumentException
-     */
-    public static function create($password): Password
-    {
-        if ($password instanceof Password) {
-            return $password;
-        }
+	/**
+	 * @param mixed $password
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public static function create($password): Password
+	{
+		if ($password instanceof Password) {
+			return $password;
+		}
 
-        return new Password($password);
-    }
+		return new Password($password);
+	}
 
-    /**
-     * {@inheritdoc}
-     *
-     * @return string
-     */
-    public function getValue(): string
-    {
-        return $this->value;
-    }
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return string
+	 */
+	public function getValue(): string
+	{
+		return $this->value;
+	}
 }

src/Uri/Component/Path.php

Indentation +34 added lines, -34 removed lines

@@ -22,43 +22,43 @@
  */
 final class Path implements ComponentInterface
 {
-    // phpcs:ignore Generic.Files.LineLength
-    private const NORMALIZATION_REGEX = '/(?:%[0-9A-Fa-f]{2}|[\x21\x24\x26-\x3b\x3d\x40-\x5a\x5f\x61-\x7a\x7e]+)|(.?)/u';
+	// phpcs:ignore Generic.Files.LineLength
+	private const NORMALIZATION_REGEX = '/(?:%[0-9A-Fa-f]{2}|[\x21\x24\x26-\x3b\x3d\x40-\x5a\x5f\x61-\x7a\x7e]+)|(.?)/u';
 
-    private string $value = '';
+	private string $value = '';
 
-    /**
-     * @param mixed $value
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct($value)
-    {
-        if ($value === '') {
-            return;
-        }
+	/**
+	 * @param mixed $value
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct($value)
+	{
+		if ($value === '') {
+			return;
+		}
 
-        if (!is_string($value)) {
-            throw new InvalidArgumentException('URI component "path" must be a string');
-        }
+		if (!is_string($value)) {
+			throw new InvalidArgumentException('URI component "path" must be a string');
+		}
 
-        $this->value = (string) preg_replace_callback(
-            self::NORMALIZATION_REGEX,
-            static fn(array $matches): string => (
-                /** @var array{0: string, 1?: string} $matches */
-                isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
-            ),
-            $value,
-        );
-    }
+		$this->value = (string) preg_replace_callback(
+			self::NORMALIZATION_REGEX,
+			static fn(array $matches): string => (
+				/** @var array{0: string, 1?: string} $matches */
+				isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
+			),
+			$value,
+		);
+	}
 
-    /**
-     * {@inheritdoc}
-     *
-     * @return string
-     */
-    public function getValue(): string
-    {
-        return $this->value;
-    }
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return string
+	 */
+	public function getValue(): string
+	{
+		return $this->value;
+	}
 }

src/Uri/Component/ComponentInterface.php

Indentation +4 added lines, -4 removed lines

@@ -13,8 +13,8 @@
 
 interface ComponentInterface
 {
-    /**
-     * @return mixed
-     */
-    public function getValue();
+	/**
+	 * @return mixed
+	 */
+	public function getValue();
 }

src/Uri/Component/Host.php

Indentation +36 added lines, -36 removed lines

@@ -23,46 +23,46 @@
  */
 final class Host implements ComponentInterface
 {
-    // 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';
+	// 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';
 
-    private string $value = '';
+	private string $value = '';
 
-    /**
-     * @param mixed $value
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct($value)
-    {
-        if ($value === '') {
-            return;
-        }
+	/**
+	 * @param mixed $value
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct($value)
+	{
+		if ($value === '') {
+			return;
+		}
 
-        if (!is_string($value)) {
-            throw new InvalidArgumentException('URI component "host" must be a string');
-        }
+		if (!is_string($value)) {
+			throw new InvalidArgumentException('URI component "host" must be a string');
+		}
 
-        $this->value = (string) preg_replace_callback(
-            self::NORMALIZATION_REGEX,
-            static fn(array $matches): string => (
-                /** @var array{0: string, 1?: string} $matches */
-                isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
-            ),
-            $value,
-        );
+		$this->value = (string) preg_replace_callback(
+			self::NORMALIZATION_REGEX,
+			static fn(array $matches): string => (
+				/** @var array{0: string, 1?: string} $matches */
+				isset($matches[1]) ? rawurlencode($matches[1]) : $matches[0]
+			),
+			$value,
+		);
 
-        // the component is case-insensitive...
-        $this->value = strtolower($this->value);
-    }
+		// the component is case-insensitive...
+		$this->value = strtolower($this->value);
+	}
 
-    /**
-     * {@inheritdoc}
-     *
-     * @return string
-     */
-    public function getValue(): string
-    {
-        return $this->value;
-    }
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return string
+	 */
+	public function getValue(): string
+	{
+		return $this->value;
+	}
 }

src/Uri/Component/Scheme.php

Indentation +36 added lines, -36 removed lines

@@ -22,40 +22,40 @@
  */
 final class Scheme implements ComponentInterface
 {
-    private const VALIDATION_REGEX = '/^(?:[A-Za-z][0-9A-Za-z\x2b\x2d\x2e]*)?$/';
-
-    private string $value = '';
-
-    /**
-     * @param mixed $value
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct($value)
-    {
-        if ($value === '') {
-            return;
-        }
-
-        if (!is_string($value)) {
-            throw new InvalidArgumentException('URI component "scheme" must be a string');
-        }
-
-        if (!preg_match(self::VALIDATION_REGEX, $value)) {
-            throw new InvalidArgumentException('Invalid URI component "scheme"');
-        }
-
-        // the component is case-insensitive...
-        $this->value = strtolower($value);
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * @return string
-     */
-    public function getValue(): string
-    {
-        return $this->value;
-    }
+	private const VALIDATION_REGEX = '/^(?:[A-Za-z][0-9A-Za-z\x2b\x2d\x2e]*)?$/';
+
+	private string $value = '';
+
+	/**
+	 * @param mixed $value
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct($value)
+	{
+		if ($value === '') {
+			return;
+		}
+
+		if (!is_string($value)) {
+			throw new InvalidArgumentException('URI component "scheme" must be a string');
+		}
+
+		if (!preg_match(self::VALIDATION_REGEX, $value)) {
+			throw new InvalidArgumentException('Invalid URI component "scheme"');
+		}
+
+		// the component is case-insensitive...
+		$this->value = strtolower($value);
+	}
+
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return string
+	 */
+	public function getValue(): string
+	{
+		return $this->value;
+	}
 }

src/HeaderInterface.php

Indentation +7 added lines, -7 removed lines

@@ -18,17 +18,17 @@
  */
 interface HeaderInterface extends IteratorAggregate
 {
-    public const RFC822_DATE_FORMAT = 'D, d M y H:i:s O';
+	public const RFC822_DATE_FORMAT = 'D, d M y H:i:s O';
 
-    public const RFC7230_TOKEN_REGEX = '/^[\x21\x23-\x27\x2A\x2B\x2D\x2E\x30-\x39\x41-\x5A\x5E-\x7A\x7C\x7E]+$/';
+	public const RFC7230_TOKEN_REGEX = '/^[\x21\x23-\x27\x2A\x2B\x2D\x2E\x30-\x39\x41-\x5A\x5E-\x7A\x7C\x7E]+$/';
 
-    public const RFC7230_FIELD_VALUE_REGEX = '/^[\x09\x20-\x7E\x80-\xFF]*$/';
+	public const RFC7230_FIELD_VALUE_REGEX = '/^[\x09\x20-\x7E\x80-\xFF]*$/';
 
-    public const RFC7230_QUOTED_STRING_REGEX = '/^(?:[\x5C][\x22]|[\x09\x20\x21\x23-\x5B\x5D-\x7E\x80-\xFF])*$/';
+	public const RFC7230_QUOTED_STRING_REGEX = '/^(?:[\x5C][\x22]|[\x09\x20\x21\x23-\x5B\x5D-\x7E\x80-\xFF])*$/';
 
-    public function getFieldName(): string;
+	public function getFieldName(): string;
 
-    public function getFieldValue(): string;
+	public function getFieldValue(): string;
 
-    public function __toString(): string;
+	public function __toString(): string;
 }

src/Response.php

Indentation +194 added lines, -194 removed lines

@@ -22,198 +22,198 @@
 
 class Response extends Message implements ResponseInterface, StatusCodeInterface
 {
-    /**
-     * List of Reason Phrases
-     *
-     * @link http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
-     *
-     * @var array<int<100, 599>, non-empty-string>
-     */
-    public const REASON_PHRASES = [
-        // 1xx
-        100 => 'Continue',
-        101 => 'Switching Protocols',
-        102 => 'Processing',
-        103 => 'Early Hints',
-        // 2xx
-        200 => 'OK',
-        201 => 'Created',
-        202 => 'Accepted',
-        203 => 'Non-Authoritative Information',
-        204 => 'No Content',
-        205 => 'Reset Content',
-        206 => 'Partial Content',
-        207 => 'Multi-Status',
-        208 => 'Already Reported',
-        226 => 'IM Used',
-        // 3xx
-        300 => 'Multiple Choices',
-        301 => 'Moved Permanently',
-        302 => 'Found',
-        303 => 'See Other',
-        304 => 'Not Modified',
-        305 => 'Use Proxy',
-        307 => 'Temporary Redirect',
-        308 => 'Permanent Redirect',
-        // 4xx
-        400 => 'Bad Request',
-        401 => 'Unauthorized',
-        402 => 'Payment Required',
-        403 => 'Forbidden',
-        404 => 'Not Found',
-        405 => 'Method Not Allowed',
-        406 => 'Not Acceptable',
-        407 => 'Proxy Authentication Required',
-        408 => 'Request Timeout',
-        409 => 'Conflict',
-        410 => 'Gone',
-        411 => 'Length Required',
-        412 => 'Precondition Failed',
-        413 => 'Payload Too Large',
-        414 => 'URI Too Long',
-        415 => 'Unsupported Media Type',
-        416 => 'Range Not Satisfiable',
-        417 => 'Expectation Failed',
-        421 => 'Misdirected Request',
-        422 => 'Unprocessable Entity',
-        423 => 'Locked',
-        424 => 'Failed Dependency',
-        425 => 'Too Early',
-        426 => 'Upgrade Required',
-        428 => 'Precondition Required',
-        429 => 'Too Many Requests',
-        431 => 'Request Header Fields Too Large',
-        451 => 'Unavailable For Legal Reasons',
-        // 5xx
-        500 => 'Internal Server Error',
-        501 => 'Not Implemented',
-        502 => 'Bad Gateway',
-        503 => 'Service Unavailable',
-        504 => 'Gateway Timeout',
-        505 => 'HTTP Version Not Supported',
-        506 => 'Variant Also Negotiates',
-        507 => 'Insufficient Storage',
-        508 => 'Loop Detected',
-        510 => 'Not Extended',
-        511 => 'Network Authentication Required',
-    ];
-
-    private int $statusCode = self::STATUS_OK;
-    private string $reasonPhrase = self::REASON_PHRASES[self::STATUS_OK];
-
-    /**
-     * @param array<string, string|string[]>|null $headers
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct(
-        ?int $statusCode = null,
-        ?string $reasonPhrase = null,
-        ?array $headers = null,
-        ?StreamInterface $body = null
-    ) {
-        if ($statusCode !== null) {
-            $this->setStatus($statusCode, $reasonPhrase ?? '');
-        }
-
-        if ($headers !== null) {
-            $this->setHeaders($headers);
-        }
-
-        if ($body !== null) {
-            $this->setBody($body);
-        }
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function getStatusCode(): int
-    {
-        return $this->statusCode;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function getReasonPhrase(): string
-    {
-        return $this->reasonPhrase;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function withStatus($code, $reasonPhrase = ''): ResponseInterface
-    {
-        $clone = clone $this;
-        $clone->setStatus($code, $reasonPhrase);
-
-        return $clone;
-    }
-
-    /**
-     * Sets the given status code to the response
-     *
-     * @param int $statusCode
-     * @param string $reasonPhrase
-     *
-     * @throws InvalidArgumentException
-     */
-    final protected function setStatus($statusCode, $reasonPhrase): void
-    {
-        $this->validateStatusCode($statusCode);
-        $this->validateReasonPhrase($reasonPhrase);
-
-        if ($reasonPhrase === '') {
-            $reasonPhrase = self::REASON_PHRASES[$statusCode] ?? 'Unknown Status Code';
-        }
-
-        $this->statusCode = $statusCode;
-        $this->reasonPhrase = $reasonPhrase;
-    }
-
-    /**
-     * Validates the given status code
-     *
-     * @link https://tools.ietf.org/html/rfc7230#section-3.1.2
-     *
-     * @param mixed $statusCode
-     *
-     * @throws InvalidArgumentException
-     */
-    private function validateStatusCode($statusCode): void
-    {
-        if (!is_int($statusCode)) {
-            throw new InvalidArgumentException('HTTP status code must be an integer');
-        }
-
-        if (!($statusCode >= 100 && $statusCode <= 599)) {
-            throw new InvalidArgumentException('Invalid HTTP status code');
-        }
-    }
-
-    /**
-     * Validates the given reason phrase
-     *
-     * @link https://tools.ietf.org/html/rfc7230#section-3.1.2
-     *
-     * @param mixed $reasonPhrase
-     *
-     * @throws InvalidArgumentException
-     */
-    private function validateReasonPhrase($reasonPhrase): void
-    {
-        if ($reasonPhrase === '') {
-            return;
-        }
-
-        if (!is_string($reasonPhrase)) {
-            throw new InvalidArgumentException('HTTP reason phrase must be a string');
-        }
-
-        if (!preg_match(HeaderInterface::RFC7230_FIELD_VALUE_REGEX, $reasonPhrase)) {
-            throw new InvalidArgumentException('Invalid HTTP reason phrase');
-        }
-    }
+	/**
+	 * List of Reason Phrases
+	 *
+	 * @link http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
+	 *
+	 * @var array<int<100, 599>, non-empty-string>
+	 */
+	public const REASON_PHRASES = [
+		// 1xx
+		100 => 'Continue',
+		101 => 'Switching Protocols',
+		102 => 'Processing',
+		103 => 'Early Hints',
+		// 2xx
+		200 => 'OK',
+		201 => 'Created',
+		202 => 'Accepted',
+		203 => 'Non-Authoritative Information',
+		204 => 'No Content',
+		205 => 'Reset Content',
+		206 => 'Partial Content',
+		207 => 'Multi-Status',
+		208 => 'Already Reported',
+		226 => 'IM Used',
+		// 3xx
+		300 => 'Multiple Choices',
+		301 => 'Moved Permanently',
+		302 => 'Found',
+		303 => 'See Other',
+		304 => 'Not Modified',
+		305 => 'Use Proxy',
+		307 => 'Temporary Redirect',
+		308 => 'Permanent Redirect',
+		// 4xx
+		400 => 'Bad Request',
+		401 => 'Unauthorized',
+		402 => 'Payment Required',
+		403 => 'Forbidden',
+		404 => 'Not Found',
+		405 => 'Method Not Allowed',
+		406 => 'Not Acceptable',
+		407 => 'Proxy Authentication Required',
+		408 => 'Request Timeout',
+		409 => 'Conflict',
+		410 => 'Gone',
+		411 => 'Length Required',
+		412 => 'Precondition Failed',
+		413 => 'Payload Too Large',
+		414 => 'URI Too Long',
+		415 => 'Unsupported Media Type',
+		416 => 'Range Not Satisfiable',
+		417 => 'Expectation Failed',
+		421 => 'Misdirected Request',
+		422 => 'Unprocessable Entity',
+		423 => 'Locked',
+		424 => 'Failed Dependency',
+		425 => 'Too Early',
+		426 => 'Upgrade Required',
+		428 => 'Precondition Required',
+		429 => 'Too Many Requests',
+		431 => 'Request Header Fields Too Large',
+		451 => 'Unavailable For Legal Reasons',
+		// 5xx
+		500 => 'Internal Server Error',
+		501 => 'Not Implemented',
+		502 => 'Bad Gateway',
+		503 => 'Service Unavailable',
+		504 => 'Gateway Timeout',
+		505 => 'HTTP Version Not Supported',
+		506 => 'Variant Also Negotiates',
+		507 => 'Insufficient Storage',
+		508 => 'Loop Detected',
+		510 => 'Not Extended',
+		511 => 'Network Authentication Required',
+	];
+
+	private int $statusCode = self::STATUS_OK;
+	private string $reasonPhrase = self::REASON_PHRASES[self::STATUS_OK];
+
+	/**
+	 * @param array<string, string|string[]>|null $headers
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct(
+		?int $statusCode = null,
+		?string $reasonPhrase = null,
+		?array $headers = null,
+		?StreamInterface $body = null
+	) {
+		if ($statusCode !== null) {
+			$this->setStatus($statusCode, $reasonPhrase ?? '');
+		}
+
+		if ($headers !== null) {
+			$this->setHeaders($headers);
+		}
+
+		if ($body !== null) {
+			$this->setBody($body);
+		}
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	public function getStatusCode(): int
+	{
+		return $this->statusCode;
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	public function getReasonPhrase(): string
+	{
+		return $this->reasonPhrase;
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	public function withStatus($code, $reasonPhrase = ''): ResponseInterface
+	{
+		$clone = clone $this;
+		$clone->setStatus($code, $reasonPhrase);
+
+		return $clone;
+	}
+
+	/**
+	 * Sets the given status code to the response
+	 *
+	 * @param int $statusCode
+	 * @param string $reasonPhrase
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	final protected function setStatus($statusCode, $reasonPhrase): void
+	{
+		$this->validateStatusCode($statusCode);
+		$this->validateReasonPhrase($reasonPhrase);
+
+		if ($reasonPhrase === '') {
+			$reasonPhrase = self::REASON_PHRASES[$statusCode] ?? 'Unknown Status Code';
+		}
+
+		$this->statusCode = $statusCode;
+		$this->reasonPhrase = $reasonPhrase;
+	}
+
+	/**
+	 * Validates the given status code
+	 *
+	 * @link https://tools.ietf.org/html/rfc7230#section-3.1.2
+	 *
+	 * @param mixed $statusCode
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	private function validateStatusCode($statusCode): void
+	{
+		if (!is_int($statusCode)) {
+			throw new InvalidArgumentException('HTTP status code must be an integer');
+		}
+
+		if (!($statusCode >= 100 && $statusCode <= 599)) {
+			throw new InvalidArgumentException('Invalid HTTP status code');
+		}
+	}
+
+	/**
+	 * Validates the given reason phrase
+	 *
+	 * @link https://tools.ietf.org/html/rfc7230#section-3.1.2
+	 *
+	 * @param mixed $reasonPhrase
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	private function validateReasonPhrase($reasonPhrase): void
+	{
+		if ($reasonPhrase === '') {
+			return;
+		}
+
+		if (!is_string($reasonPhrase)) {
+			throw new InvalidArgumentException('HTTP reason phrase must be a string');
+		}
+
+		if (!preg_match(HeaderInterface::RFC7230_FIELD_VALUE_REGEX, $reasonPhrase)) {
+			throw new InvalidArgumentException('Invalid HTTP reason phrase');
+		}
+	}
 }