TYPO3 v15 dev-main snapshot ()

Classes/Http/MiddlewareDispatcher.php

@@ -0,0 +1,135 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Core\Http;
+
+use Psr\Container\ContainerInterface;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Server\MiddlewareInterface;
+use Psr\Http\Server\RequestHandlerInterface;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
+/**
+ * MiddlewareDispatcher
+ *
+ * This class manages and dispatches a PSR-15 middleware stack.
+ *
+ * @internal
+ */
+class MiddlewareDispatcher implements RequestHandlerInterface
+{
+    /**
+     * Tip of the middleware call stack
+     *
+     * @var RequestHandlerInterface
+     */
+    protected $tip;
+
+    /**
+     * @var ContainerInterface|null
+     */
+    protected $container;
+
+    public function __construct(
+        RequestHandlerInterface $kernel,
+        iterable $middlewares = [],
+        ?ContainerInterface $container = null
+    ) {
+        $this->container = $container;
+        $this->seedMiddlewareStack($kernel);
+
+        foreach ($middlewares as $middleware) {
+            if (is_string($middleware)) {
+                $this->lazy($middleware);
+            } else {
+                $this->add($middleware);
+            }
+        }
+    }
+
+    /**
+     * Invoke the middleware stack
+     */
+    public function handle(ServerRequestInterface $request): ResponseInterface
+    {
+        return $this->tip->handle($request);
+    }
+
+    /**
+     * Seed the middleware stack with the inner request handler
+     */
+    protected function seedMiddlewareStack(RequestHandlerInterface $kernel)
+    {
+        $this->tip = $kernel;
+    }
+
+    /**
+     * Add a new middleware to the stack
+     *
+     * Middlewares are organized as a stack. That means middlewares
+     * that have been added before will be executed after the newly
+     * added one (last in, first out).
+     */
+    public function add(MiddlewareInterface $middleware): void
+    {
+        $next = $this->tip;
+        $this->tip = new class ($middleware, $next) implements RequestHandlerInterface {
+            public function __construct(private readonly MiddlewareInterface $middleware, private readonly RequestHandlerInterface $next) {}
+
+            public function handle(ServerRequestInterface $request): ResponseInterface
+            {
+                return $this->middleware->process($request, $this->next);
+            }
+        };
+    }
+
+    /**
+     * Add a new middleware by class name
+     *
+     * Middlewares are organized as a stack. That means middlewares
+     * that have been added before will be executed after the newly
+     * added one (last in, first out).
+     *
+     * @param string $middleware
+     */
+    public function lazy(string $middleware): void
+    {
+        $next = $this->tip;
+        $this->tip = new class ($middleware, $next, $this->container) implements RequestHandlerInterface {
+            public function __construct(
+                private readonly string $middleware,
+                private readonly RequestHandlerInterface $next,
+                private readonly ?ContainerInterface $container = null
+            ) {}
+
+            public function handle(ServerRequestInterface $request): ResponseInterface
+            {
+                if ($this->container !== null && $this->container->has($this->middleware)) {
+                    $middleware = $this->container->get($this->middleware);
+                } else {
+                    $middleware = GeneralUtility::makeInstance($this->middleware);
+                }
+
+                if (!$middleware instanceof MiddlewareInterface) {
+                    throw new \InvalidArgumentException(get_class($middleware) . ' does not implement ' . MiddlewareInterface::class, 1516821342);
+                }
+                return $middleware->process($request, $this->next);
+            }
+        };
+    }
+}