Http response exceptions

src/ResponseStatusException/AbstractResponseStatusException.php

@@ -0,0 +1,16 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\HttpException;
+
+abstract class AbstractResponseStatusException extends HttpException {
+	public function __construct(string $message = "") {
+		parent::__construct(
+			$message,
+			$this->getHttpCode(),
+			null
+		);
+	}
+
+	abstract protected function getHttpCode():int;
+}

src/ResponseStatusException/HttpBadGateway.php

@@ -0,0 +1,15 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The server was acting as a gateway or proxy and received an invalid response
+ * from the upstream server.
+ * @link https://httpstatuses.com/502
+ */
+class HttpBadGateway extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::BAD_GATEWAY;
+	}
+}

src/ResponseStatusException/HttpBadRequest.php

@@ -0,0 +1,16 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The server cannot or will not process the request due to an apparent client
+ * error (e.g., malformed request syntax, size too large, invalid request
+ * message framing, or deceptive request routing).
+ * @link https://httpstatuses.com/400
+ */
+class HttpBadRequest extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::BAD_REQUEST;
+	}
+}

src/ResponseStatusException/HttpConflict.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpConflict extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::CONFLICT;
+	}
+}

src/ResponseStatusException/HttpExpectationFailed.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpExpectationFailed extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::EXPECTATION_FAILED;
+	}
+}

src/ResponseStatusException/HttpFailedDependency.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpFailedDependency extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::FAILED_DEPENDENCY;
+	}
+}

src/ResponseStatusException/HttpForbidden.php

@@ -0,0 +1,20 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The request contained valid data and was understood by the server, but the
+ * server is refusing action. This may be due to the user not having the
+ * necessary permissions for a resource or needing an account of some sort, or
+ * attempting a prohibited action (e.g. creating a duplicate record where only
+ * one is allowed). This code is also typically used if the request provided
+ * authentication via the WWW-Authenticate header field, but the server did not
+ * accept that authentication. The request should not be repeated.
+ * @link https://httpstatuses.com/403
+ */
+class HttpForbidden extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::FORBIDDEN;
+	}
+}

src/ResponseStatusException/HttpFound.php

@@ -0,0 +1,21 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * Tells the client to look at (browse to) another URL. 302 has been superseded
+ * by 303 and 307. This is an example of industry practice contradicting the
+ * standard. The HTTP/1.0 specification (RFC 1945) required the client to
+ * perform a temporary redirect (the original describing phrase was
+ * "Moved Temporarily"), but popular browsers implemented 302 with the
+ * functionality of a 303 See Other. Therefore, HTTP/1.1 added status codes 303
+ * and 307 to distinguish between the two behaviours. However, some Web
+ * applications and frameworks use the 302 status code as if it were the 303.
+ * @link https://httpstatuses.com/302
+ */
+class HttpFound extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::FOUND;
+	}
+}

src/ResponseStatusException/HttpGatewayTimeout.php

@@ -0,0 +1,15 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The server was acting as a gateway or proxy and did not receive a timely
+ * response from the upstream server.
+ * @link https://httpstatuses.com/504
+ */
+class HttpGatewayTimeout extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::GATEWAY_TIMEOUT;
+	}
+}

src/ResponseStatusException/HttpGone.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpGone extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::GONE;
+	}
+}

src/ResponseStatusException/HttpImATeapot.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpImATeapot extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::IM_A_TEAPOT;
+	}
+}

src/ResponseStatusException/HttpInsufficientStorage.php

@@ -0,0 +1,15 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The server is unable to store the representation needed to complete the
+ * request.
+ * @link https://httpstatuses.com/507
+ */
+class HttpInsufficientStorage extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::INSUFFICIENT_STORAGE;
+	}
+}

src/ResponseStatusException/HttpInternalServerError.php

@@ -0,0 +1,15 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * A generic error message, given when an unexpected condition was encountered
+ * and no more specific message is suitable.
+ * @link https://httpstatuses.com/500
+ */
+class HttpInternalServerError extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::INTERNAL_SERVER_ERROR;
+	}
+}

src/ResponseStatusException/HttpLengthRequired.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpLengthRequired extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::LENGTH_REQUIRED;
+	}
+}

src/ResponseStatusException/HttpLocked.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpLocked extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::LOCKED;
+	}
+}

src/ResponseStatusException/HttpLoopDetected.php

@@ -0,0 +1,15 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The server detected an infinite loop while processing the request (sent
+ * instead of 208 Already Reported).
+ * @link https://httpstatuses.com/508
+ */
+class HttpLoopDetected extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::LOOP_DETECTED;
+	}
+}

src/ResponseStatusException/HttpMethodNotAllowed.php

@@ -0,0 +1,16 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * A request method is not supported for the requested resource; for example, a
+ * GET request on a form that requires data to be presented via POST, or a PUT
+ * request on a read-only resource.
+ * @link https://httpstatuses.com/405
+ */
+class HttpMethodNotAllowed extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::METHOD_NOT_ALLOWED;
+	}
+}

src/ResponseStatusException/HttpMisdirectedRequest.php

@@ -0,0 +1,10 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+class HttpMisdirectedRequest extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::MISDIRECTED_REQUEST;
+	}
+}

src/ResponseStatusException/HttpMovedPermanently.php

@@ -0,0 +1,14 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * This and all future requests should be directed to the given URI.
+ * @link https://httpstatuses.com/301
+ */
+class HttpMovedPermanently extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::MOVED_PERMANENTLY;
+	}
+}

src/ResponseStatusException/HttpMultipleChoices.php

@@ -0,0 +1,17 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * Indicates multiple options for the resource from which the client may choose
+ * (via agent-driven content negotiation). For example, this code could be used
+ * to present multiple video format options, to list files with different
+ * filename extensions, or to suggest word-sense disambiguation.
+ * @link https://httpstatuses.com/300
+ */
+class HttpMultipleChoices extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::MULTIPLE_CHOICES;
+	}
+}

src/ResponseStatusException/HttpNetworkAuthenticationRequired.php

@@ -0,0 +1,17 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The client needs to authenticate to gain network access. Intended for use by
+ * intercepting proxies used to control access to the network (e.g., "captive
+ * portals" used to require agreement to Terms of Service before granting full
+ * Internet access via a Wi-Fi hotspot).
+ * @link https://httpstatuses.com/511
+ */
+class HttpNetworkAuthenticationRequired extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::NETWORK_AUTHENTICATION_REQUIRED;
+	}
+}

src/ResponseStatusException/HttpNotAcceptable.php

@@ -0,0 +1,15 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The requested resource is capable of generating only content not acceptable
+ * according to the Accept headers sent in the request.
+ * @linkhttps://httpstatuses.com/406
+ */
+class HttpNotAcceptable extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::NOT_ACCEPTABLE;
+	}
+}

src/ResponseStatusException/HttpNotExtended.php

@@ -0,0 +1,14 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * Further extensions to the request are required for the server to fulfil it.
+ * @link https://httpstatuses.com/510
+ */
+class HttpNotExtended extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::NOT_EXTENDED;
+	}
+}

src/ResponseStatusException/HttpNotFound.php

@@ -0,0 +1,15 @@
+<?php
+namespace Gt\Http\ResponseStatusException;
+
+use Gt\Http\StatusCode;
+
+/**
+ * The requested resource could not be found but may be available in the future.
+ * Subsequent requests by the client are permissible.
+ * @link https://httpstatuses.com/404
+ */
+class HttpNotFound extends AbstractResponseStatusException {
+	protected function getHttpCode():int {
+		return StatusCode::NOT_FOUND;
+	}
+}