Flight\Routing\Routes\DomainRoute

Complexity

Total Complexity

17

Size/Duplication

Total Lines	120
Duplicated Lines	0 %

Importance

Changes

0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	6	1
A	path()	0	3	1
A	domain()	0	15	4
A	scheme()	0	7	2
A	to()	0	3	1
A	resolvePattern()	0	19	5
A	match()	0	11	3

<?php

declare(strict_types=1);

/*
 * This file is part of Flight Routing.
 *
 * PHP version 7.1 and above required
 *
 * @author    Divine Niiquaye Ibok <divineibok@gmail.com>
 * @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\Routes;

use Flight\Routing\Exceptions\UriHandlerException;
use Psr\Http\Message\UriInterface;

/**
 * Value object representing a single route.
 *
 * The default support for this route class includes FastRoute support:
 * - hosts binding
 * - schemes binding
 * - domain and schemes casting from route pattern
 *
 * @method string[] getSchemes() Gets the route hosts schemes.
 * @method string[] getHosts()   Gets the route hosts.
 *
 * @author Divine Niiquaye Ibok <divineibok@gmail.com>
 */
class DomainRoute extends FastRoute
{
    /**
     * A Pattern to match protocol, host and port from a url.
     *
     * Examples of urls that can be matched: http://en.example.domain, {sub}.example.domain, https://example.com:34, example.com, etc.
     *
     * @var string[]
     */
    public const URL_PATTERN = ['#^(?:([a-z]+)\:\/{2})?([^\/]+)?$#u', '#^(?:([a-z]+)\:)?(?:\/{2}([^\/]+))?(?:(\/.*))?$#u'];

    protected static $getter = [
        'name' => 'name',
        'path' => 'path',
        'methods' => 'methods*',
        'schemes' => 'schemes*',
        'hosts' => 'hosts*',
        'handler' => 'handler',
        'arguments' => 'arguments*',
        'patterns' => 'patterns*',
        'defaults' => 'defaults*',
    ];

    public function __construct(string $pattern, $methods = self::DEFAULT_METHODS, $handler = null)
    {
        parent::__construct('', $methods, $handler);

        // Resolve route pattern ...
        $this->data['path'] .= $this->resolvePattern($pattern);
    }

    /**
     * {@inheritdoc}
     */
    public static function to(string $pattern, $methods = self::DEFAULT_METHODS, $handler = null): self
    {
        return parent::to($pattern, $methods, $handler);

The expression return parent::to($pattern, $methods, $handler) returns the type Flight\Routing\Routes\FastRoute which includes types incompatible with the type-hinted return Flight\Routing\Routes\DomainRoute.

    }

    /**
     * {@inheritdoc}
     *
     * @throws UriHandlerException
     */
    public function match(string $method, UriInterface $uri): self
    {
        if (isset($this->data['schemes'])) {
            if (\in_array($uri->getScheme(), $this->get('schemes'), true)) {

It seems like $this->get('schemes') can also be of type null; however, parameter $haystack of in_array() does only seem to accept array, maybe add an additional type check?

                return $this;
            }

            throw new UriHandlerException(\sprintf('Unfortunately current scheme "%s" is not allowed on requested uri [%s].', $uri->getScheme(), $uri->getPath()), 400);
        }

        return parent::match($method, $uri);

The expression return parent::match($method, $uri) returns the type Flight\Routing\Routes\FastRoute which includes types incompatible with the type-hinted return Flight\Routing\Routes\DomainRoute.

    }

    /**
     * {@inheritdoc}
     */
    public function path(string $pattern): self
    {
        return parent::path($this->resolvePattern($pattern));

The expression return parent::path($this->resolvePattern($pattern)) returns the type Flight\Routing\Routes\FastRoute which includes types incompatible with the type-hinted return Flight\Routing\Routes\DomainRoute.

    }

    /**
     * Sets the requirement of host on this Route.
     *
     * @param string $hosts The host for which this route should be enabled
     */
    public function domain(string ...$hosts): self
    {
        foreach ($hosts as $host) {
            \preg_match(self::URL_PATTERN[0], $host, $matches, \PREG_UNMATCHED_AS_NULL);

            if (isset($matches[1])) {
                $this->data['schemes'][] = $matches[1];
            }

            if (isset($matches[2])) {
                $this->data['hosts'][] = $matches[2];
            }
        }

        return $this;
    }

    /**
     * Sets the requirement of domain scheme on this Route.
     *
     * @param string ...$schemes
     */
    public function scheme(string ...$schemes): self
    {
        foreach ($schemes as $scheme) {
            $this->data['schemes'][] = \strtolower($scheme);
        }

        return $this;
    }

    protected function resolvePattern(string $pattern): string
    {
        \preg_match(self::URL_PATTERN[1], $pattern, $matches, \PREG_UNMATCHED_AS_NULL);

        if (!empty($matches)) {
            if (isset($matches[1])) {
                $this->data['schemes'][] = $matches[1];
            }

            if (isset($matches[2])) {
                $this->data['hosts'][] = $matches[2];
            }

            if (!isset($matches[3])) {
                throw new UriHandlerException('A route path not could not be found, Did you forget include one.');
            }
        }

        return $matches[3] ?? $pattern;
    }
}