Split Adapter::getContainer() into getContainer + getContext

Before, getContainer() did double duty: returning the request-scoped
container when inside a coroutine, the global container otherwise. That
made request-side reads/writes look like global ones (\$server->getContainer()
inside match()), which obscured the scope split.

Now:
- getContainer() always returns the global singleton container.
- getContext() returns the per-request context container (coroutine-local
  under Swoole, identical to the global one under FPM). Lookups still
  fall through to the global container's parent chain, so getContext()
  resolves singletons too.

Http internals updated to call getContext() for all per-request reads
and writes; the constructor's setup of \$this->container keeps using
getContainer() since it's grabbing the global.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: loks0n

src/Http/Adapter.php

@@ -11,5 +11,21 @@ abstract class Adapter
     abstract public function onStart(callable $callback): void;
     abstract public function onRequest(callable $callback): void;
     abstract public function start(): void;
+
+    /**
+     * Return the global container — the singleton-scoped registry shared
+     * across all requests. Use this for resources that should outlive a
+     * single request (clients, configs, etc.).
+     */
     abstract public function getContainer(): Container;
+
+    /**
+     * Return the per-request context container. Coroutine-local under the
+     * Swoole adapters; identical to getContainer() under FPM. Use this for
+     * values scoped to a single request — request, response, route,
+     * matchedPath, error, etc. Lookups fall through to the global
+     * container's parent chain, so getContext()->get('someSingleton')
+     * still resolves.
+     */
+    abstract public function getContext(): Container;
 }

src/Http/Adapter/FPM/Server.php

@@ -30,5 +30,10 @@ public function getContainer(): Container
         return $this->container;
     }
 
+    public function getContext(): Container
+    {
+        return $this->container;
+    }
+
     public function start(): void {}
 }

src/Http/Adapter/Swoole/Server.php

@@ -39,6 +39,11 @@ public function onRequest(callable $callback): void
     }
 
     public function getContainer(): Container
+    {
+        return $this->container;
+    }
+
+    public function getContext(): Container
     {
         if (Coroutine::getCid() !== -1) {
             return Coroutine::getContext()[self::CONTEXT_KEY] ?? $this->container;

src/Http/Adapter/SwooleCoroutine/Server.php

@@ -51,6 +51,11 @@ public function onRequest(callable $callback): void
     }
 
     public function getContainer(): Container
+    {
+        return $this->container;
+    }
+
+    public function getContext(): Container
     {
         return Coroutine::getContext()[self::CONTEXT_KEY] ?? $this->container;
     }

src/Http/Http.php

@@ -363,7 +363,7 @@ public static function setAllowOverride(bool $value): void
     public function getResource(string $name): mixed
     {
         try {
-            return $this->server->getContainer()->get($name);
+            return $this->server->getContext()->get($name);
         } catch (ContainerExceptionInterface|NotFoundExceptionInterface $e) {
             // Normalize DI container errors to the Http layer's "resource" terminology.
             $message = str_replace('dependency', 'resource', $e->getMessage());
@@ -418,7 +418,7 @@ public function setResource(string $name, callable $callback, array $injections
      */
     protected function setContext(string $name, callable $callback, array $injections = []): void
     {
-        $this->server->getContainer()->set($name, $callback, $injections);
+        $this->server->getContext()->set($name, $callback, $injections);
     }
 
     /**
@@ -569,7 +569,7 @@ public function start(): void
      */
     public function match(Request $request, bool $fresh = true): ?Route
     {
-        $context = $this->server->getContainer();
+        $context = $this->server->getContext();
 
         if (!$fresh && $context->has('route')) {
             $cached = $context->get('route');
@@ -605,7 +605,7 @@ public function execute(Route $route, Request $request, Response $response): sta
         $arguments = [];
         $groups = $route->getGroups();
 
-        $context = $this->server->getContainer();
+        $context = $this->server->getContext();
         $matchedPath = $context->has('matchedPath') ? $context->get('matchedPath') : '';
         $preparedPath = Router::preparePath($matchedPath);
         $pathValues = $route->getPathValues($request, $preparedPath[0]);
@@ -738,7 +738,7 @@ public function run(Request $request, Response $response): static
         $result = $this->runInternal($request, $response);
 
         $requestDuration = microtime(true) - $start;
-        $context = $this->server->getContainer();
+        $context = $this->server->getContext();
         $route = $context->has('route') ? $context->get('route') : null;
         $attributes = [
             'url.scheme' => $request->getProtocol(),