feat: New http exceptions (502 and 503).

Signed-off-by: Johannes Tegnér <johannes@jitesoft.com>

Author: Johannestegner

src/Http/Server/HttpBadGatewayException.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Jitesoft\Exceptions\Http\Server;
+
+use Jitesoft\Exceptions\Http\HttpException;
+use Throwable;
+
+/**
+ * Class HttpBadGatewayException
+ *
+ * Server http exception thrown when the server - working as a gateway - encounters
+ * an error in the response from the server.
+ */
+class HttpBadGatewayException extends HttpException {
+
+    /**
+     * HttpBadGatewayException constructor.
+     *
+     * @param string         $message
+     * @param int            $code
+     * @param Throwable|null $previous
+     */
+    public function __construct(
+        string $message = "Bad Gateway.",
+        int $code = 502,
+        ?Throwable $previous = null
+    ) {
+        parent::__construct($message, $code, $previous);
+    }
+
+}

src/Http/Server/HttpServiceUnavailableException.php

@@ -0,0 +1,50 @@
+<?php
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+  HttpServiceUnavailableException.php - Part of the php-exceptions project.
+
+  © - Jitesoft
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+namespace Jitesoft\Exceptions\Http\Server;
+
+use Jitesoft\Exceptions\Http\HttpException;
+use Throwable;
+
+/**
+ * Class HttpServiceUnavailableException
+ *
+ * Server http exception thrown when a request is not possible to be handled.
+ *
+ * It is recommended to set the retry-after header in the response to allow the client
+ * to retry the request after the given time.
+ */
+class HttpServiceUnavailableException extends HttpException {
+
+    protected ?int $retryAfter;
+
+    /**
+     * Retry-After header value which should be set if possible.
+     *
+     * @return int|null
+     */
+    public function getRetryAfter(): ?int {
+        return $this->retryAfter;
+    }
+
+    /**
+     * HttpServiceUnavailableException constructor.
+     *
+     * @param string         $message
+     * @param int            $code
+     * @param ?int           $retryAfter
+     * @param Throwable|null $previous
+     */
+    public function __construct(
+        string $message =
+            "Service is currently not able to handle the request.",
+        int $code = 503,
+        ?int $retryAfter = null,
+        ?Throwable $previous = null
+    ) {
+        parent::__construct($message, $code, $previous);
+    }
+}

tests/Http/Server/HttpBadGatewayExceptionTest.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Jitesoft\Exceptions\Tests\Http\Server;
+
+use Jitesoft\Exceptions\Http\Server\HttpBadGatewayException;
+use Jitesoft\Exceptions\Tests\Http\HttpExceptionTest;
+
+class HttpBadGatewayExceptionTest  extends HttpExceptionTest {
+
+    protected $expectedErrorCode = 502;
+
+    protected function throwDefaultException(): void {
+        throw new HttpBadGatewayException();
+    }
+
+    public function throwMessageException(string $message): void {
+        throw new HttpBadGatewayException($message);
+    }
+}

tests/Http/Server/HttpServiceUnavailableExceptionTest.php

@@ -0,0 +1,25 @@
+<?php
+namespace Jitesoft\Exceptions\Tests\Http\Server;
+
+use Jitesoft\Exceptions\Http\Server\HttpServiceUnavailableException;
+use Jitesoft\Exceptions\Tests\Http\HttpExceptionTest;
+
+/**
+ * @group Exceptions
+ * @group HttpExceptions
+ * @group RuntimeExceptions
+ * @group HttpServerExceptions
+ */
+class HttpServiceUnavailableExceptionTest extends HttpExceptionTest {
+
+    protected $expectedErrorCode = 503;
+
+    protected function throwDefaultException(): void {
+        throw new HttpServiceUnavailableException();
+    }
+
+    public function throwMessageException(string $message): void {
+        throw new HttpServiceUnavailableException($message);
+    }
+
+}