feat: Implemented new http client exceptions (418, 425 and 451).

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

Author: Johannestegner

src/Http/Client/HttpImATeapotException.php

@@ -0,0 +1,38 @@
+<?php
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+  HttpImATeapotException.php - Part of the php-exceptions project.
+
+  © - Jitesoft
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+namespace Jitesoft\Exceptions\Http\Client;
+
+use Jitesoft\Exceptions\Http\HttpException;
+use Jitesoft\Exceptions\Http\Server\HttpNotImplementedException;
+use Throwable;
+
+/**
+ * Class HttpImATeapotException
+ *
+ * Client http exception which is thrown when server is a coffee brewer hence can't make tea.
+ *
+ * This is a standardized joke, the http error is sometimes used to indicate that something is not
+ * fully implemented (in which case @see HttpNotImplementedException would be preferable.
+ */
+class HttpImATeapotException extends HttpException {
+
+    /**
+     * HttpImATeapotException constructor.
+     *
+     * @param string         $message
+     * @param int            $code
+     * @param Throwable|null $previous
+     */
+    public function __construct(
+        string $message = "I'm a teapot.",
+        int $code = 418,
+        ?Throwable $previous = null
+    ) {
+        parent::__construct($message, $code, $previous);
+    }
+
+}

src/Http/Client/HttpToEarlyException.php

@@ -0,0 +1,37 @@
+<?php
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+  HttpToEarlyException.php - Part of the php-exceptions project.
+
+  © - Jitesoft
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+namespace Jitesoft\Exceptions\Http\Client;
+
+use Jitesoft\Exceptions\Http\HttpException;
+use Throwable;
+
+/**
+ * Class HttptoEarlyException
+ *
+ * Client http exception which is used to indicate that the server is unwilling
+ * to risk processing the request that might be replayed.
+ *
+ * This is an experimental http status code which might change.
+ */
+class HttpToEarlyException extends HttpException {
+
+    /**
+     * HttpToEarlyException constructor.
+     *
+     * @param string         $message
+     * @param int            $code
+     * @param Throwable|null $previous
+     */
+    public function __construct(
+        string $message = 'To early.',
+        int $code = 425,
+        ?Throwable $previous = null
+    ) {
+        parent::__construct($message, $code, $previous);
+    }
+
+}

src/Http/Client/HttpUnavailableForLegalReasonsException.php

@@ -0,0 +1,50 @@
+<?php
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+  HttpUnavailableForLegalReasonsException.php - Part of the php-exceptions project.
+
+  © - Jitesoft
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+namespace Jitesoft\Exceptions\Http\Client;
+
+use Jitesoft\Exceptions\Http\HttpException;
+use Throwable;
+
+/**
+ * Class HttpUnavailableForLegalReasonsException
+ *
+ * Client http exception thrown when a requested resource is unavailable
+ * due to legal reasons hence can't be served.
+ */
+class HttpUnavailableForLegalReasonsException extends HttpException {
+
+    private ?string $reason;
+
+    /**
+     * Reason for unavailability.
+     *
+     * @return string|null
+     */
+    public function getReason(): ?string {
+        return $this->reason;
+    }
+
+    /**
+     * HttpUnavailableForLegalReasonsException constructor.
+     *
+     * @param string         $message
+     * @param string|null    $reason
+     * @param int            $code
+     * @param Throwable|null $previous
+     */
+    public function __construct(
+        string $message = 'Unavailable for Legal Reasons.',
+        ?string $reason = null,
+        int $code = 451,
+        ?Throwable $previous = null
+    ) {
+        parent::__construct($message, $code, $previous);
+
+        $this->reason = $reason;
+    }
+
+}

src/Http/Server/HttpBadGatewayException.php

@@ -1,5 +1,9 @@
 <?php
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+  HttpBadGatewayException.php - Part of the php-exceptions project.
 
+  © - Jitesoft
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 namespace Jitesoft\Exceptions\Http\Server;
 
 use Jitesoft\Exceptions\Http\HttpException;
@@ -21,7 +25,7 @@ class HttpBadGatewayException extends HttpException {
      * @param Throwable|null $previous
      */
     public function __construct(
-        string $message = "Bad Gateway.",
+        string $message = 'Bad Gateway.',
         int $code = 502,
         ?Throwable $previous = null
     ) {

src/Http/Server/HttpServiceUnavailableException.php

@@ -18,7 +18,6 @@
  * to retry the request after the given time.
  */
 class HttpServiceUnavailableException extends HttpException {
-
     protected ?int $retryAfter;
 
     /**
@@ -39,12 +38,15 @@ public function getRetryAfter(): ?int {
      * @param Throwable|null $previous
      */
     public function __construct(
-        string $message =
-            "Service is currently not able to handle the request.",
+        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);
+
+        $this->retryAfter = $retryAfter;
     }
+
 }