RouteCollection::options() - Code Metrics - Inspection of "Fixed coding standard issues" - divineniiquaye/flight-routing - Measure and Improve Code Quality continuously with Scrutinizer

Test Failed
Push — master ( 08de7a...d45f24 )

by Divine Niiquaye
created 2021-10-08 12:25 UTC
RouteCollection::options() A

↳ Parent: RouteCollection
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	2
CRAP Score	1
Importance

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

declare(strict_types=1);

/*
 * This file is part of Flight Routing.
 *
 * PHP version 7.4 and above required
 *
 * @author    Divine Niiquaye Ibok <[email protected]>
 * @copyright 2019 Biurad Group (https://biurad.com/)
 * @license   https://opensource.org/licenses/BSD-3-Clause License
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Flight\Routing;

/**
 * A RouteCollection represents a set of Route instances.
 *
 * This class provides all(*) methods for creating path+HTTP method-based routes and
 * injecting them into the router:
 *
 * - head
 * - get
 * - post
 * - put
 * - patch
 * - delete
 * - options
 * - any
 * - resource
 *
 * A general `addRoute()` method allows specifying multiple request methods and/or
 * arbitrary request methods when creating a path-based route.
 *
 * @method RouteCollection assert(string $variable, string|string[] $regexp)
 * @method RouteCollection default(string $variable, mixed $default)
 * @method RouteCollection argument(string $variable, mixed $value)
 * @method RouteCollection method(string ...$methods)
 * @method RouteCollection scheme(string ...$schemes)
 * @method RouteCollection domain(string ...$hosts)
 * @method RouteCollection prefix(string $path)
 * @method RouteCollection defaults(array $values)
 * @method RouteCollection asserts(array $patterns)
 * @method RouteCollection arguments(array $parameters)
 * @method RouteCollection namespace(string $namespace)
 * @method RouteCollection piped(string ...$to)
 *
 * @author Divine Niiquaye Ibok <[email protected]>
 */
final class RouteCollection
{
    private ?self $parent = null;

    /** @var array<string,mixed[]>|null */
    private ?array $prototypes = [];

    /** @var array<string,bool> */
    private array $prototyped = [];

    /** @var Routes\FastRoute[] */
    private iterable $routes = [];

    /** @var self[] */
    private array $groups = [];

    private ?string $uniqueId;

    private string $namedPrefix;

    /**
     * @param string $namedPrefix The unqiue name for this group
     */
    public function __construct(string $namedPrefix = '')
    {
        $this->namedPrefix = $namedPrefix;
        $this->uniqueId = (string) \uniqid($namedPrefix);
    }

    /**
     * Nested collection and routes should be cloned.
     */
    public function __clone()
    {
        foreach ($this->routes as $offset => $route) {
            $this->routes[$offset] = clone $route;
        }
    }

    /**
     * @param string[] $arguments
     */
    public function __call(string $routeMethod, array $arguments): self
    {
        $routeMethod = \strtolower($routeMethod);

        if (isset($this->prototyped[$this->uniqueId])) {
            $this->prototypes[$routeMethod] = \array_merge($this->prototypes[$routeMethod] ?? [], $arguments);
        } else {
            foreach ($this->routes as $route) {
                \call_user_func_array([$route, $routeMethod], $arguments);
            }

            if (\array_key_exists($routeMethod, $this->prototypes ?? [])) {
                unset($this->prototypes[$routeMethod]);
            }

            foreach ($this->groups as $group) {
                \call_user_func_array([$group, $routeMethod], $arguments);
            }
        }

        return $this;
    }

    /**
     * @return iterable<Routes\FastRoute>
     */
    public function getRoutes(): iterable
    {
        $routes = $this->routes;


        if ($routes instanceof \SplFixedArray) {
            return $routes;
        }

        if (!empty($this->groups)) {
            $this->injectGroups('', $routes);
        }

        $this->uniqueId = null; // Lock grouping and prototyping

        return $this->routes = self::sortRoutes($routes);
    }

    /**
     * Merge a collection into base.
     *
     * @throws \RuntimeException if locked
     */
    public function populate(self $collection, bool $asGroup = false): void
    {
        if ($asGroup) {
            if (null === $this->uniqueId) {
                throw new \RuntimeException('Populating a route collection as group must be done before calling the getRoutes() method.');
            }

            $this->groups[] = $collection;
        } else {
            $routes = $collection->routes;


            if (!empty($collection->groups)) {
                $collection->injectGroups($collection->namedPrefix, $routes);
            }

            foreach ($routes as $route) {
                $this->routes[] = $this->injectRoute($route);
            }

            $collection->routes = $collection->prototypes = [];
        }
    }

    /**
     * Add route to the collection.
     */
    public function add(Routes\FastRoute $route): self
    {
        $this->routes[] = $this->injectRoute($route);

        return $this;
    }

    /**
     * Maps a pattern to a handler.
     *
     * You can must specify HTTP methods that should be matched.
     *
     * @param string   $pattern Matched route pattern
     * @param string[] $methods Matched HTTP methods
     * @param mixed    $handler Handler that returns the response when matched
     */
    public function addRoute(string $pattern, array $methods, $handler = null): Routes\Route
    {
        return $this->routes[] = $this->injectRoute(new Routes\Route($pattern, $methods, $handler));
    }

    /**
     * Same as addRoute method, except uses Routes\FastRoute class.
     *
     * @param string   $pattern Matched route pattern
     * @param string[] $methods Matched HTTP methods
     * @param mixed    $handler Handler that returns the response when matched
     */
    public function fastRoute(string $pattern, array $methods, $handler = null): Routes\FastRoute
    {
        return $this->routes[] = $this->injectRoute(new Routes\FastRoute($pattern, $methods, $handler));
    }

    /**
     * Add routes to the collection.
     *
     * @param Routes\FastRoute[] $routes
     *
     * @throws \TypeError if $routes doesn't contain a fast route instance
     * @throws \RuntimeException if locked
     */
    public function routes(array $routes): self
    {
        foreach ($routes as $route) {
            $this->routes[] = $this->injectRoute($route);
        }

        return $this;
    }

    /**
     * Mounts controllers under the given route prefix.
     *
     * @param string                   $name        The route group prefixed name
     * @param callable|RouteCollection $controllers A RouteCollection instance or a callable for defining routes
     *
     * @throws \TypeError        if $controllers not instance of route collection's class
     * @throws \RuntimeException if locked
     */
    public function group(string $name, $controllers = null): self
    {
        if (null === $this->uniqueId) {
            throw new \RuntimeException('Grouping index invalid or out of range, add group before calling the getRoutes() method.');
        }

        if (\is_callable($controllers)) {
            $routes = new static($name);
            $routes->prototypes = $this->prototypes ?? [];
            $controllers($routes);

            return $this->groups[] = $routes;
        }

        return $this->groups[] = $this->injectGroup($name, $controllers ?? new static($name));
        return $this->groups[] = $this->injectGroup($name, /** @scrutinizer ignore-type */ $controllers ?? new static($name));
    }

    /**
     * Allows a proxied method call to route's.
     *
     * @throws \RuntimeException if locked
     */
    public function prototype(): self
    {
        if (null === $uniqueId = $this->uniqueId) {
            throw new \RuntimeException('Routes method prototyping must be done before calling the getRoutes() method.');
        }

        $this->prototypes = (null !== $this->parent) ? ($this->parent->prototypes ?? []) : [];
        $this->prototyped[$uniqueId] = true; // Prototyping calls to routes ...

        return $this;
    }

    /**
     * Unmounts a group collection to continue routes stalk.
     */
    public function end(): self
    {
        if (isset($this->prototyped[$this->uniqueId])) {
            unset($this->prototyped[$this->uniqueId]);

            // Remove last element from stack.
            if (null !== $stack = $this->prototypes) {
                \array_pop($stack);
            }

            return $this;
        }

        return $this->parent ?? $this;
    }

    /**
     * Maps a HEAD request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function head(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, [Router::METHOD_HEAD], $handler);
    }

    /**
     * Maps a GET and HEAD request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function get(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, [Router::METHOD_GET, Router::METHOD_HEAD], $handler);
    }

    /**
     * Maps a POST request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function post(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, [Router::METHOD_POST], $handler);
    }

    /**
     * Maps a PUT request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function put(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, [Router::METHOD_PUT], $handler);
    }

    /**
     * Maps a PATCH request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function patch(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, [Router::METHOD_PATCH], $handler);
    }

    /**
     * Maps a DELETE request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function delete(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, [Router::METHOD_DELETE], $handler);
    }

    /**
     * Maps a OPTIONS request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function options(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, [Router::METHOD_OPTIONS], $handler);
    }

    /**
     * Maps any request to a handler.
     *
     * @param string $pattern Matched route pattern
     * @param mixed  $handler Handler that returns the response when matched
     */
    public function any(string $pattern, $handler = null): Routes\Route
    {
        return $this->addRoute($pattern, Router::HTTP_METHODS_STANDARD, $handler);
    }

    /**
     * Maps any Router::HTTP_METHODS_STANDARD request to a resource handler prefixed to $action's method name.
     *
     * E.g: Having pattern as "/accounts/{userId}", all request made from supported request methods
     * are to have the same url.
     *
     * @param string              $action   The prefixed name attached to request method
     * @param string              $pattern  matched path where request should be sent to
     * @param class-string|object $resource Handler that returns the response

     */
    public function resource(string $pattern, $resource, string $action = 'action'): Routes\Route
    {
        return $this->any($pattern, new Handlers\ResourceHandler($resource, $action));
    }

    /**
     * Rearranges routes, sorting static paths before dynamic paths.
     *
     * @param Routes\FastRoute[] $routes
     *
     * @return \SplFixedArray<Routes\FastRoute>
     */
    private static function sortRoutes(array $routes): \SplFixedArray
    {
        $sortRegex = '#^\\/[\\/\\w]+$#';

        \usort($routes, static function (Routes\FastRoute $a, Routes\FastRoute $b) use ($sortRegex): int {
            $aB = \preg_match($sortRegex, $aP = $a->getPath());
            $bB = \preg_match($sortRegex, $bP = $b->getPath());

            return $aB && $bB ? 0 : ($aB < $bB ? +1 : ($aB > $bB ? -1 : \strcmp($aP, $bP)));
        });

        return \SplFixedArray::fromArray($routes);
    }

    /**
     * @throws \RuntimeException if locked
     */
    private function injectRoute(Routes\FastRoute $route): Routes\FastRoute
    {
        foreach ($this->prototypes ?? [] as $routeMethod => $arguments) {
            if (empty($arguments)) {
                continue;
            }

            \call_user_func_array([$route, $routeMethod], 'prefix' === $routeMethod ? [\implode('', $arguments)] : $arguments);
        }

        if (null !== $this->parent) {
            $route->belong($this); // Attach grouping to route.
        }

        return $route;
    }

    private function injectGroup(string $prefix, self $controllers): self
    {
        $controllers->prototypes = $this->prototypes ?? [];
        $controllers->parent = $this;

        if (empty($controllers->namedPrefix)) {
            $controllers->namedPrefix = $prefix;
        }

        return $controllers;
    }

    /**
     * @param iterable<int,Routes\FastRoute> $collection
     */
    private function injectGroups(string $prefix, iterable &$collection): void
    {
        $unnamedRoutes = [];

        foreach ($this->groups as $group) {
            foreach ($group->routes as $route) {
                if (empty($name = $route->getName())) {
                    $name = $route->generateRouteName('');

                    if (isset($unnamedRoutes[$name])) {
                        $name .= ('_' !== $name[-1] ? '_' : '') . ++$unnamedRoutes[$name];
                    } else {
                        $unnamedRoutes[$name] = 0;
                    }
                }

                $collection[] = $route->bind($prefix . $group->namedPrefix . $name);
            }

            if (!empty($group->groups)) {
                $group->injectGroups($prefix . $group->namedPrefix, $collection);
            }
        }

        $this->groups = [];
    }
}

divineniiquaye / flight-routing

Push — master ( 08de7a...d45f24 )

RouteCollection::options() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
