Yiisoft\Router\CurrentRoute

Complexity

Total Complexity

16

Size/Duplication

Total Lines	112
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	getMethods()	0	3	2
A	getName()	0	3	2
A	getHost()	0	3	2
A	getUri()	0	3	1
A	getPattern()	0	3	2
A	getArguments()	0	3	1
A	getArgument()	0	3	1
A	setUri()	0	7	2
A	setRouteWithArguments()	0	8	3

<?php

declare(strict_types=1);

namespace Yiisoft\Router;

use LogicException;
use Psr\Http\Message\UriInterface;

/**
 * Holds information about current route e.g. matched last.
 */
final class CurrentRoute
{
    /**
     * Current Route.
     */
    private ?Route $route = null;

    /**
     * Current URI.
     */
    private ?UriInterface $uri = null;

    /**
     * Current Route arguments.
     *
     * @var string[]
     *
     * @psalm-var array<string, string>
     */
    private array $arguments = [];

    /**
     * Returns the current route name.
     *
     * @return string|null The current route name.
     */
    public function getName(): ?string
    {
        return $this->route !== null ? $this->route->getData('name') : null;
    }

    /**
     * Returns the current route host.
     *
     * @return string|null The current route host.
     */
    public function getHost(): ?string
    {
        return $this->route !== null ? $this->route->getData('host') : null;
    }

    /**
     * Returns the current route pattern.
     *
     * @return string|null The current route pattern.
     */
    public function getPattern(): ?string
    {
        return $this->route !== null ? $this->route->getData('pattern') : null;
    }

    /**
     * Returns the current route methods.
     *
     * @return string[]|null The current route methods.
     */
    public function getMethods(): ?array
    {
        return $this->route !== null ? $this->route->getData('methods') : null;
    }

    /**
     * Returns the current URI.
     *
     * @return UriInterface|null The current URI.
     */
    public function getUri(): ?UriInterface
    {
        return $this->uri;
    }

    /**
     * @param string[] $arguments
     *
     * @psalm-param array<string,string> $arguments
     *
     * @internal
     */
    public function setRouteWithArguments(Route $route, array $arguments): void
    {
        if ($this->route === null && $this->arguments === []) {
            $this->route = $route;
            $this->arguments = $arguments;
            return;
        }
        throw new LogicException('Can not set route/arguments since it was already set.');
    }

    /**
     * @internal
     */
    public function setUri(UriInterface $uri): void
    {
        if ($this->uri === null) {
            $this->uri = $uri;
            return;
        }
        throw new LogicException('Can not set URI since it was already set.');
    }

    /**
     * @return string[] Arguments.
     * @psalm-return array<string, string>
     */
    public function getArguments(): array
    {
        return $this->arguments;
    }

    public function getArgument(string $name, ?string $default = null): ?string
    {
        return $this->arguments[$name] ?? $default;
    }
}