I implemented a straightforward cookie collection mechanism

README.md

@@ -146,6 +146,46 @@ $cookie = (new \Yiisoft\Cookies\Cookie('cookieName'))
     ->withRawValue('ebaKUq90PhiHck_MR7st-E1SxhbYWiTsLo82mCTbNuAh7rgflx5LVsYfJJseyQCrODuVcJkTSYhm1WKte-l5lQ==')
 ```
 
+Work with cookie request collection from any place in you project. Add in config you app in middleware block
+```php
+ 'middlewares' => [
+        \Yiisoft\Cookies\RequestCookies\RequestCookiesCollectorMiddleware::class,
+        ...
+    ],
+```
+
+Initial provider in di-web config
+```php
+return [
+    ...,
+    \Yiisoft\Cookies\RequestCookies\RequestCookiesProviderInterface::class => [
+        'class' => Yiisoft\Cookies\RequestCookies\RequestCookiesProvider::class,
+    ],
+
+```
+
+Use as dependency in any part of ur code
+
+```php
+
+use Yiisoft\Cookies\RequestCookies\RequestCookiesProviderInterface;
+
+final class MyService
+{
+    public function __construct(
+        private RequestCookiesProviderInterface $requestCookieProvider
+    )
+    {    
+    }
+
+    public function doIt()
+    {
+        $cookieCollection = $this->requestCookieProvider->get();
+        // ...
+    }
+}
+```
+```
 ## Documentation
 
 - [Internals](docs/internals.md)

composer.json

@@ -46,6 +46,7 @@
         "roave/infection-static-analysis-plugin": "^1.16",
         "spatie/phpunit-watcher": "^1.23",
         "vimeo/psalm": "^4.30|^5.21",
+        "yiisoft/di": "1.1",
         "yiisoft/test-support": "^1.3"
     },
     "autoload": {
@@ -58,6 +59,14 @@
             "Yiisoft\\Cookies\\Tests\\": "tests"
         }
     },
+    "extra": {
+        "config-plugin-options": {
+            "source-directory": "config"
+        },
+        "config-plugin": {
+            "di-web": "di-web.php"
+        }
+    },
     "config": {
         "sort-packages": true,
         "allow-plugins": {

config/di-web.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+/** @var array $params */
+
+use Yiisoft\Cookies\RequestCookies\RequestCookiesProvider;
+use Yiisoft\Cookies\RequestCookies\RequestCookiesProviderInterface;
+
+return [
+    RequestCookiesProviderInterface::class => [
+        'class' => RequestCookiesProvider::class,
+    ],
+];

src/RequestCookies/Exception/RequestCookieCollectionNotSetException.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Cookies\RequestCookies\Exception;
+
+use LogicException;
+use Throwable;
+
+/**
+ * Thrown when Request cookie collect isn't set before.
+ */
+final class RequestCookieCollectionNotSetException extends LogicException
+{
+    public function __construct(int $code = 0, ?Throwable $previous = null)
+    {
+        parent::__construct('Request cookie collect is not set.', $code, $previous);
+    }
+}

src/RequestCookies/RequestCookies.php

@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Cookies\RequestCookies;
+
+/**
+ * A RequestCookies helps to work with many cookies at once and to read request cookies.
+ */
+final class RequestCookies
+{
+    /**
+     * @var array The cookies in this collection (indexed by the cookie name).
+     *
+     * @psalm-var array<string, string>
+     */
+    private array $cookies = [];
+
+    /**
+     * RequestCookies constructor.
+     *
+     * @param array<string, string> $cookies The cookies that this collection initially contains.
+     */
+    public function __construct(array $cookies = [])
+    {
+        foreach ($cookies as $name => $value) {
+            $this->cookies[$name] = $value;
+        }
+    }
+
+    /**
+     * Returns the cookie with the specified name.
+     *
+     * @param string $name The cookie name.
+     *
+     * @return ?string The cookie with the specified name. Null if the named cookie does not exist.
+     *
+     * @see getValue()
+     */
+    public function get(string $name): ?string
+    {
+        return $this->cookies[$name] ?? null;
+    }
+
+    /**
+     * Returns whether there is a cookie with the specified name.
+     *
+     * @param string $name The cookie name.
+     *
+     * @return bool Whether the named cookie exists.
+     *
+     * @see remove()
+     */
+    public function has(string $name): bool
+    {
+        return isset($this->cookies[$name]);
+    }
+}

src/RequestCookies/RequestCookiesCollectorMiddleware.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Cookies\RequestCookies;
+
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Server\MiddlewareInterface;
+use Psr\Http\Server\RequestHandlerInterface;
+
+/**
+ * Stores cookies request  {@see RequestCookiesProviderInterface}.
+ * You need to add this into your application middleware stack.
+ */
+final class RequestCookiesCollectorMiddleware implements MiddlewareInterface
+{
+    private RequestCookiesProviderInterface $cookieProvider;
+
+    public function __construct(RequestCookiesProviderInterface $cookieProvider)
+    {
+        $this->cookieProvider = $cookieProvider;
+    }
+
+    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
+    {
+        $cookies = $this->collectCookies($request);
+        $this->cookieProvider->set(new RequestCookies($cookies));
+        return $handler->handle($request);
+    }
+
+    /**
+     * @param ServerRequestInterface $request
+     * @return array<string, string>
+     */
+    private function collectCookies(ServerRequestInterface $request): array
+    {
+        $collection = [];
+        foreach ($request->getCookieParams() as $name => $value) {
+            if (!is_string($name) || !is_string($value)) {
+                continue;
+            }
+            $collection[$name] = $value;
+        }
+        return $collection;
+    }
+}

src/RequestCookies/RequestCookiesProvider.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Cookies\RequestCookies;
+
+use Yiisoft\Cookies\RequestCookies\Exception\RequestCookieCollectionNotSetException;
+
+/**
+ * Stores request for further consumption by attribute handlers.
+ */
+final class RequestCookiesProvider implements RequestCookiesProviderInterface
+{
+    /**
+     * @var RequestCookies|null The collection.
+     */
+    private ?RequestCookies $cookieCollection = null;
+
+    public function set(RequestCookies $cookieCollection): void
+    {
+        $this->cookieCollection = $cookieCollection;
+    }
+
+    public function get(): RequestCookies
+    {
+        if ($this->cookieCollection === null) {
+            throw new RequestCookieCollectionNotSetException();
+        }
+
+        return $this->cookieCollection;
+    }
+}

src/RequestCookies/RequestCookiesProviderInterface.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Cookies\RequestCookies;
+
+use Yiisoft\Cookies\RequestCookies\Exception\RequestCookieCollectionNotSetException;
+
+/**
+ * Provides a way to set the current cookie collection and then get it when needed.
+ */
+interface RequestCookiesProviderInterface
+{
+    /**
+     * Set the current cookie request collection.
+     *
+     * @param RequestCookies $cookieCollection The collection to set.
+     */
+    public function set(RequestCookies $cookieCollection): void;
+
+    /**
+     * Get the current request cookie collection.
+     *
+     * @throws RequestCookieCollectionNotSetException
+     */
+    public function get(): RequestCookies;
+}

tests/ConfigTest.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Cookies\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Yiisoft\Cookies\RequestCookies\RequestCookiesProvider;
+use Yiisoft\Cookies\RequestCookies\RequestCookiesProviderInterface;
+use Yiisoft\Di\Container;
+use Yiisoft\Di\ContainerConfig;
+
+use function dirname;
+
+final class ConfigTest extends TestCase
+{
+    public function testDi(): void
+    {
+        $container = $this->createContainer();
+
+        $this->assertInstanceOf(
+            RequestCookiesProvider::class,
+            $container->get(RequestCookiesProviderInterface::class)
+        );
+    }
+
+    private function createContainer(): Container
+    {
+        return new Container(
+            ContainerConfig::create()->withDefinitions($this->getContainerDefinitions())
+        );
+    }
+
+    private function getContainerDefinitions(): array
+    {
+        return require dirname(__DIR__) . '/config/di-web.php';
+    }
+}