feat: add parameter source attributes for Query, Header, and Cookie

Author: patel-vansh

system/CodeIgniter.php

@@ -18,6 +18,10 @@
 use CodeIgniter\Exceptions\LogicException;
 use CodeIgniter\Exceptions\PageNotFoundException;
 use CodeIgniter\Filters\Filters;
+use CodeIgniter\HTTP\Attributes\ParamSource\BaseParamSourceAttribute;
+use CodeIgniter\HTTP\Attributes\ParamSource\Cookie;
+use CodeIgniter\HTTP\Attributes\ParamSource\Header;
+use CodeIgniter\HTTP\Attributes\ParamSource\Query;
 use CodeIgniter\HTTP\CLIRequest;
 use CodeIgniter\HTTP\Exceptions\FormRequestException;
 use CodeIgniter\HTTP\Exceptions\RedirectException;
@@ -728,7 +732,32 @@ private function resolveCallableParams(ReflectionFunctionAbstract $reflection, a
         $resolved   = [];
         $routeIndex = 0;
 
+        $request = service('request');
+
         foreach ($reflection->getParameters() as $param) {
+            $attrs = $param->getAttributes();
+
+            if (count($attrs) > 0) {
+                foreach ($attrs as $attr) {
+                    $instance = $attr->newInstance();
+
+                    if (! $instance instanceof BaseParamSourceAttribute) {
+                        continue;
+                    }
+
+                    $key = $instance->getKey($param->getName());
+
+                    $resolved[] = match (true) {
+                        $instance instanceof Query  => $request->getGet($key),
+                        $instance instanceof Header => $request->getHeaderLine($key),
+                        $instance instanceof Cookie => $request->getCookie($key),
+                        default                     => throw new LogicException('Unsupported parameter attribute: ' . $instance::class),
+                    };
+
+                    continue 2;
+                }
+            }
+
             [$kind, $formRequestClass] = CallableParamClassifier::classify($param);
 
             switch ($kind) {

system/HTTP/Attributes/ParamSource/BaseParamSourceAttribute.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\HTTP\Attributes\ParamSource;
+
+abstract class BaseParamSourceAttribute
+{
+    public function __construct(private readonly ?string $key = null)
+    {
+    }
+
+    public function getKey(string $paramName): string
+    {
+        return $this->key ?? $paramName;
+    }
+}

system/HTTP/Attributes/ParamSource/Cookie.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\HTTP\Attributes\ParamSource;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_PARAMETER)]
+class Cookie extends BaseParamSourceAttribute
+{
+}

system/HTTP/Attributes/ParamSource/Header.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\HTTP\Attributes\ParamSource;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_PARAMETER)]
+class Header extends BaseParamSourceAttribute
+{
+}

system/HTTP/Attributes/ParamSource/Query.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\HTTP\Attributes\ParamSource;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_PARAMETER)]
+class Query extends BaseParamSourceAttribute
+{
+}