Http response exceptions (#35)

* Build up request URI in parts for greater compatibility

* Created HTTP response exceptions up to 408

* Http 4xx exceptions

* Http 5xx exceptions

* Missing StatusCode constants

Author: Greg Bowler

src/HttpRedirectException.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/AbstractResponseStatusException.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/HttpBadGateway.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/HttpBadRequest.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/HttpConflict.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/HttpExpectationFailed.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/HttpFailedDependency.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/HttpForbidden.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/HttpFound.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;
+	}
+}