MiddlewareQueue::seek() - Code Metrics - Inspection of "Merge pull request #19 from blitz-php/devs" - blitz-php/framework - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — main ( f83e77...eadd2b )

by Dimitri
created 2024-09-04 11:56 UTC
MiddlewareQueue::seek() A

↳ Parent: MiddlewareQueue
Complexity

Conditions	2
Paths	2
Size

Total Lines	7
Code Lines	3
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	2
CRAP Score	2
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	2
eloc	3
c	1
b	0
f	0
nc	2
nop	1
dl	0
loc	7
ccs	2
cts	2
cp	1
crap	2
rs	10
<?php

/**
 * This file is part of Blitz PHP framework.
 *
 * (c) 2022 Dimitri Sitchet Tomkeu <[email protected]>
 *
 * For the full copyright and license information, please view
 * the LICENSE file that was distributed with this source code.
 */

namespace BlitzPHP\Http;

use BlitzPHP\Container\Container;
use BlitzPHP\Middlewares\BaseMiddleware;
use BlitzPHP\Middlewares\ClosureDecorator;
use Closure;
use Countable;
use InvalidArgumentException;
use LogicException;
use OutOfBoundsException;
use Psr\Http\Server\MiddlewareInterface;
use SeekableIterator;

class MiddlewareQueue implements Countable, SeekableIterator
{
    /**
     * Index du middleware actuellement executer
     */
    protected int $position = 0;

    /**
     * Aliases des middlewares
     */
    protected array $aliases = [];

    /**
     * Groupes de middlewares
     *
     * @var array<string, array>
     */
    protected array $groups = [];

    /**
     * Constructor
     *
     * @param array $queue Liste des middlewares a executer pour la requete courante
     */
    public function __construct(protected Container $container, protected array $queue = [], protected ?Request $request = null, protected ?Response $response = null)
    {
        $this->request  = $request ?: $this->container->get(Request::class);
        $this->response = $response ?: $this->container->get(Response::class);
    }

    /**
     * Ajoute un alias de middleware
     */
    public function alias(string $alias, Closure|MiddlewareInterface|string $middleware): static
    {
        return $this->aliases([$alias => $middleware]);
    }

    /**
     * Ajoute des alias de middlewares
     *
     * @param array<string, Closure|MiddlewareInterface|string> $aliases
     */
    public function aliases(array $aliases): static
    {
        $this->aliases = array_merge($this->aliases, $aliases);

        return $this;
    }

    /**
     * Ajoute des groupes de middlewares
     *
     * @param array<string, array> $groups
     */
    public function groups(array $groups): static
    {
        $this->groups = array_merge($this->groups, $groups);

        return $this;
    }

    /**
     * Ajoute un middleware a la chaine d'execution
     */
    public function add(array|Closure|MiddlewareInterface|string $middleware): static
    {
        if (is_array($middleware)) {

            $this->queue = array_merge($this->queue, $middleware);

            return $this;
        }
        $this->queue[] = $middleware;

        return $this;
    }

    /**
     * Alias pour MiddlewareQueue::add().
     *
     * @see MiddlewareQueue::add()
     */
    public function push(array|Closure|MiddlewareInterface|string $middleware): static
    {
        return $this->add($middleware);
    }

    /**
     * Ajoute un middleware en bout de chaine
     *
     * Alias pour MiddlewareQueue::add().
     *
     * @see MiddlewareQueue::add()
     */
    public function append(array|Closure|MiddlewareInterface|string $middleware): static
    {
        return $this->add($middleware);
    }

    /**
     * Ajoute un middleware en debut de chaine
     */
    public function prepend(array|Closure|MiddlewareInterface|string $middleware): static
    {
        if (is_array($middleware)) {

            $this->queue = array_merge($middleware, $this->queue);

            return $this;
        }
        array_unshift($this->queue, $middleware);

        return $this;
    }

    /**
     * insert un middleware a une position donnee.
     *
     * Alias pour MiddlewareQueue::add().
     *
     * @param int $index La position où le middleware doit être insérer.
     *
     * @see MiddlewareQueue::add()
     */
    public function insert(int $index, Closure|MiddlewareInterface|string $middleware): static
    {
        return $this->insertAt($index, $middleware);
    }

    /**
     * Insérez un middleware appelable à un index spécifique.
     *
     * Si l'index existe déjà, le nouvel appelable sera inséré,
     * et l'élément existant sera décalé d'un indice supérieur.
     *
     * @param int $index La position où le middleware doit être insérer.
     */
    public function insertAt(int $index, Closure|MiddlewareInterface|string $middleware): static
    {
        array_splice($this->queue, $index, 0, [$middleware]);

        return $this;
    }

    /**
     * Insérez un objet middleware avant la première classe correspondante.
     *
     * Trouve l'index du premier middleware qui correspond à la classe fournie,
     * et insère le middleware fourni avant.
     *
     * @param string $class Le nom de classe pour insérer le middleware avant.
     *
     * @throws LogicException Si le middleware à insérer avant n'est pas trouvé.
     */
    public function insertBefore(string $class, Closure|MiddlewareInterface|string $middleware): static
    {
        $found = false;
        $i     = 0;

        if (array_key_exists($class, $this->aliases) && is_string($this->aliases[$class])) {
            $class = $this->aliases[$class];
        }

        foreach ($this->queue as $i => $object) {
            if ((is_string($object) && $object === $class) || is_a($object, $class)) {
                $found = true;
                break;
            }
        }

        if ($found) {
            return $this->insertAt($i, $middleware);
        }

        throw new LogicException(sprintf("No middleware matching '%s' could be found.", $class));
    }

    /**
     * Insérez un objet middleware après la première classe correspondante.
     *
     * Trouve l'index du premier middleware qui correspond à la classe fournie,
     * et insère le callback fourni après celui-ci. Si la classe n'est pas trouvée,
     * cette méthode se comportera comme add().
     *
     * @param string $class Le nom de classe pour insérer le middleware après.
     */
    public function insertAfter(string $class, Closure|MiddlewareInterface|string $middleware): static
    {
        $found = false;
        $i     = 0;

        if (array_key_exists($class, $this->aliases) && is_string($this->aliases[$class])) {
            $class = $this->aliases[$class];
        }

        foreach ($this->queue as $i => $object) {
            if ((is_string($object) && $object === $class) || is_a($object, $class)) {
                $found = true;
                break;
            }
        }

        if ($found) {
            return $this->insertAt($i + 1, $middleware);
        }

        return $this->add($middleware);
    }

    /**
     * Obtenir le nombre de couches middleware connectés.
     */
    public function count(): int
    {
        return count($this->queue);
    }

    /**
     * {@inheritDoc}
     */
    public function seek(int $position): void
    {
        if (! isset($this->queue[$position])) {
            throw new OutOfBoundsException(sprintf('Invalid seek position (%s).', $position));
        }

        $this->position = $position;
    }

    /**
     * {@inheritDoc}
     */
    public function rewind(): void
    {
        $this->position = 0;
    }

    /**
     *  {@inheritDoc}
     */
    public function current(): MiddlewareInterface
    {
        if (! isset($this->queue[$this->position])) {
            throw new OutOfBoundsException(sprintf('Position actuelle non valide (%s).', $this->position));
        }

        if ($this->queue[$this->position] instanceof MiddlewareInterface) {
            return $this->queue[$this->position];
        }

        return $this->queue[$this->position] = $this->resolve($this->queue[$this->position]);
    }

    /**
     * {@inheritDoc}
     */
    public function key(): int
    {
        return $this->position;
    }

    /**
     * Passe la position actuelle au middleware suivant.
     */
    public function next(): void
    {
        $this->position++;
    }

    /**
     * Vérifie si la position actuelle est valide.
     */
    public function valid(): bool
    {
        return isset($this->queue[$this->position]);
    }

    /**
     * Enregistre les middlewares definis dans le gestionnaire des middlewares
     *
     * @internal
     */
    public function register(array $config)
    {
        $config += [
            'aliases' => [],
            'globals' => [],
            'groups'  => [],
            'build'   => static fn () => null,
        ];

        $this->aliases($config['aliases']);
        $this->groups($config['groups']);

        foreach ($config['globals'] as $middleware) {
            $this->add($middleware);
        }

        if (is_callable($build = $config['build'])) {
            $this->container->call($build, [
                'request' => $this->request,
                'queue'   => $this,
            ]);
        }
    }

    /**
     * Resout les groups pour definir les middlewares
     *
     * @internal
     */
    public function resolveGroups()
    {
        foreach ($this->queue as $queue) {
            if (is_string($queue) && ! empty($this->groups[$queue])) {
                if (! is_array($this->groups[$queue])) {
                    continue;
                }

                $i = array_search($queue, $this->queue, true);
                $j = 0;

                unset($this->queue[$i]);

                foreach ($this->groups[$queue] as $middleware) {
                    $this->insertAt(($i + $j), $middleware);
                    $j++;
                }
            }
        }
    }

    /**
     * {@internal}
     */
    public function response(): Response
    {
        return $this->response;

    }

    /**
     * Résoudre le nom middleware à une instance de middleware compatible PSR 15.
     *
     * @throws InvalidArgumentException si Middleware introuvable.
     */
    protected function resolve(Closure|MiddlewareInterface|string $middleware): MiddlewareInterface
    {
        if (is_string($middleware)) {
            [$middleware, $options] = explode(':', $middleware) + [1 => null];

            if (isset($this->aliases[$middleware])) {
                $middleware = $this->aliases[$middleware];
            }

            if ($this->container->has($middleware)) {
                $middleware = $this->container->get($middleware);
            } else {
                throw new InvalidArgumentException(sprintf(
                    'Middleware, `%s` n\'a pas été trouvé.',
                    $middleware
                ));
            }

            if ($middleware instanceof BaseMiddleware) {
                if (null !== $options) {
                    $middleware->fill(explode(',', $options));
                }

                $middleware->init($this->request->getPath());
                $middleware->init($this->request->/** @scrutinizer ignore-call */ getPath());
            }
        }

        if ($middleware instanceof MiddlewareInterface) {
            return $middleware;
        }

        return new ClosureDecorator($middleware, $this->response);
        return new ClosureDecorator(/** @scrutinizer ignore-type */ $middleware, $this->response);
    }
}

blitz-php / framework

Push — main ( f83e77...eadd2b )

MiddlewareQueue::seek() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
