anonymous//src/MiddlewareFactory.php$0 - Code Metrics - Inspection of "Bind request attributes to action parameters" - yiisoft/middleware-dispatcher - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — master (#36)

by Rustam
created 2021-07-13 07:15 UTC
anonymous//src/MiddlewareFactory.php$0 A

↳ Parent: MiddlewareFactory::wrapCallable()
Complexity

Total Complexity
Size/Duplication

Total Lines	50
Duplicated Lines	0 %
Test Coverage

Coverage
100%
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
wmc	10
c	1
b	0
f	0
dl	0
loc	50
ccs	22
cts	22
cp	1
rs	10
<?php

declare(strict_types=1);

namespace Yiisoft\Middleware\Dispatcher;

use Closure;
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 Yiisoft\Injector\Injector;

use function in_array;
use function is_array;
use function is_string;

/**
 * Creates a PSR-15 middleware based on the definition provided.
 */
final class MiddlewareFactory implements MiddlewareFactoryInterface
{
    private ContainerInterface $container;

    /**
     * @param ContainerInterface $container Container to use for resolving definitions.
     */
    public function __construct(ContainerInterface $container)
    {
        $this->container = $container;
    }

    /**
     * @param array|callable|string $middlewareDefinition Middleware definition in one of the following formats:
     *
     * - A name of PSR-15 middleware class. The middleware instance will be obtained from container and executed.
     * - A callable with `function(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface`
     *   signature.
     * - A controller handler action in format `[TestController::class, 'index']`. `TestController` instance will
     *   be created and `index()` method will be executed.
     * - A function returning a middleware. The middleware returned will be executed.
     *
     * For handler action and callable
     * typed parameters are automatically injected using dependency injection container.
     * Current request and handler could be obtained by type-hinting for {@see ServerRequestInterface}
     * and {@see RequestHandlerInterface}.
     */
    public function create($middlewareDefinition): MiddlewareInterface
    {
        $this->validateMiddleware($middlewareDefinition);

        if (is_string($middlewareDefinition)) {
            /** @var MiddlewareInterface */
            return $this->container->get($middlewareDefinition);
        }

        return $this->wrapCallable($middlewareDefinition);
    }

    /**
     * @param array|callable $callback
     */
    private function wrapCallable($callback): MiddlewareInterface
    {
        if (is_array($callback)) {
            return new class($this->container, $callback) implements MiddlewareInterface {
                private string $class;
                private string $method;
                private ContainerInterface $container;
                private array $callback;

                public function __construct(ContainerInterface $container, array $callback)
                {
                    [$this->class, $this->method] = $callback;
                    $this->container = $container;
                    $this->callback = $callback;
                }

                public function process(
                    ServerRequestInterface $request,
                    RequestHandlerInterface $handler
                ): ResponseInterface {
                    /** @var mixed $controller */
                    $controller = $this->container->get($this->class);

                    /** @var mixed $response */
                    $response = (new Injector($this->container))
                        ->invoke([$controller, $this->method], $this->resolveHandlerArguments($request, $handler));
                    if ($response instanceof ResponseInterface) {
                        return $response;
                    }

                    throw new InvalidMiddlewareDefinitionException($this->callback);
                }

                private function resolveHandlerArguments(
                    ServerRequestInterface $request,
                    RequestHandlerInterface $handler
                ): array {
                    $parameters = (new \ReflectionClass($this->class))->getMethod($this->method)->getParameters();
                    $arguments = [];

                    foreach ($parameters as $parameter) {
                        if ($parameter->getType()->getName() === ServerRequestInterface::class) {
                        if ($parameter->getType()->/** @scrutinizer ignore-call */ getName() === ServerRequestInterface::class) {
                            $arguments[$parameter->getName()] = $request;
                        } else if ($parameter->getType()->getName() === RequestHandlerInterface::class) {
                            $arguments[$parameter->getName()] = $handler;
                        } else if (
                            (!$parameter->hasType() || $parameter->getType()->isBuiltin())
                            && array_key_exists($parameter->getName(), $request->getAttributes())
                        ) {
                            $arguments[$parameter->getName()] = $request->getAttribute($parameter->getName());
                        }
                    }
                    return $arguments;
                }
            };
        }

        /** @var callable $callback */

        return new class($callback, $this->container) implements MiddlewareInterface {
            private ContainerInterface $container;
            private $callback;

            public function __construct(callable $callback, ContainerInterface $container)
            {
                $this->callback = $callback;
                $this->container = $container;
            }

            public function process(
                ServerRequestInterface $request,
                RequestHandlerInterface $handler
            ): ResponseInterface {
                /** @var mixed $response */
                $response = (new Injector($this->container))->invoke(
                    $this->callback,
                    $this->resolveHandlerArguments($request, $handler)
                );
                if ($response instanceof ResponseInterface) {
                    return $response;
                }
                if ($response instanceof MiddlewareInterface) {
                    return $response->process($request, $handler);
                }
                throw new InvalidMiddlewareDefinitionException($this->callback);
            }

            private function resolveHandlerArguments(
                ServerRequestInterface $request,
                RequestHandlerInterface $handler
            ): array {
                $parameters = (new \ReflectionFunction($this->callback))->getParameters();
                $arguments = [];

                foreach ($parameters as $parameter) {
                    if ($parameter->hasType() && $parameter->getType()->getName() === ServerRequestInterface::class) {
                        $arguments[$parameter->getName()] = $request;
                    } else if ($parameter->hasType() && $parameter->getType()->getName() === RequestHandlerInterface::class) {
                        $arguments[$parameter->getName()] = $handler;
                    } else if (
                        (!$parameter->hasType() || $parameter->getType()->isBuiltin())
                        && array_key_exists($parameter->getName(), $request->getAttributes())
                    ) {
                        $arguments[$parameter->getName()] = $request->getAttribute($parameter->getName());
                    }
                }
                return $arguments;
            }
        };
    }

    /**
     * @param array|callable|string $middlewareDefinition A name of PSR-15 middleware, a callable with
     * `function(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface` signature or
     * a handler action (an array of [handlerClass, handlerMethod]). For handler action and callable typed parameters
     * are automatically injected using dependency injection container passed to the route.
     * Current request and handler could be obtained by type-hinting for {@see ServerRequestInterface}
     * and {@see RequestHandlerInterface}.
     *
     * @throws InvalidMiddlewareDefinitionException
     */
    private function validateMiddleware($middlewareDefinition): void
    {
        if (is_string($middlewareDefinition) && is_subclass_of($middlewareDefinition, MiddlewareInterface::class)) {
            return;
        }

        if ($this->isCallable($middlewareDefinition)) {
            return;
        }

        throw new InvalidMiddlewareDefinitionException($middlewareDefinition);
    }

    /**
     * @param mixed $definition
     */
    private function isCallable($definition): bool
    {
        if ($definition instanceof Closure) {
            return true;
        }

        return is_array($definition)
            && array_keys($definition) === [0, 1]
            && is_string($definition[0])
            && is_string($definition[1])
            && in_array(
                $definition[1],
                class_exists($definition[0]) ? get_class_methods($definition[0]) : [],
                true
            );
    }
}

yiisoft / middleware-dispatcher

Pull Request — master (#36)

anonymous//src/MiddlewareFactory.php$0 A

Complexity

Size/Duplication

Test Coverage

Importance

Duplication Side-by-Side

Filter issues like
