Support for request attributes

Author: BenMorel

src/Request.php

@@ -110,6 +110,11 @@ final class Request extends Message
      */
     private string $clientIp = '0.0.0.0';
 
+    /**
+     * @var array<string, mixed>
+     */
+    private array $attributes = [];
+
     /**
      * Returns a Request object representing the current request.
      *
@@ -1179,6 +1184,42 @@ public function getAcceptLanguage() : array
         return $this->parseQualityValues($this->getHeader('Accept-Language'));
     }
 
+    /**
+     * @return array<string, mixed>
+     */
+    public function getAttributes(): array
+    {
+        return $this->attributes;
+    }
+
+    public function getAttribute(string $name, $default = null)
+    {
+        if (array_key_exists($name, $this->attributes)) {
+            return $this->attributes[$name];
+        }
+
+        return $default;
+    }
+
+    /**
+     * Returns a copy of this request with the given attribute set.
+     *
+     * This instance is immutable and unaffected by this method call.
+     *
+     * @param string $name  The attribute name.
+     * @param mixed  $value The attribute value.
+     *
+     * @return Request The updated request.
+     */
+    public function withAttribute(string $name, $value): Request
+    {
+        $that = clone $this;
+
+        $that->attributes[$name] = $value;
+
+        return $that;
+    }
+
     /**
      * Parses quality values as defined per RFC 7231 § 5.3.1.
      *