gacela-project / router

src/Router/Configure/Routes.php

<?php

declare(strict_types=1);

namespace Gacela\Router\Configure;

use Gacela\Router\Controllers\RedirectController;
use Gacela\Router\Entities\Request;
use Gacela\Router\Entities\Route;
use Gacela\Router\Exceptions\MalformedPathException;
use Gacela\Router\Exceptions\UnsupportedHttpMethodException;

use Gacela\Router\Validators\PathValidator;

use function in_array;
use function is_array;

/**
 * @method head(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method connect(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method get(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method post(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method put(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method patch(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method delete(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method options(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method trace(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 * @method any(string $path, object|string $controller, string $action = '__invoke', ?string $pathPattern = null)
 */
final class Routes
{
    /** @var list<Route> */
    private array $routes = [];

    /**
     * @psalm-suppress MixedArgument
     */
    public function __call(string $method, array $arguments): void
    {
        if ($method === 'any') {
            $this->addRoute(Request::ALL_METHODS, ...$arguments);
        } else {
            $this->addRoute($method, ...$arguments);
        }
    }

    /**
     * @psalm-suppress MixedArgument
     *
     * @param string[] $methods
     * @param object|class-string $controller

The doc comment object|class-string at position 2 could not be parsed: Unknown type name 'class-string' at position 2 in object|class-string.

     */
    public function match(
        array $methods,
        string $path,
        object|string $controller,
        string $action = '__invoke',
        ?string $pathPattern = null,
    ): void {
        $this->addRoute($methods, $path, $controller, $action, $pathPattern);
    }

    public function redirect(
        string $uri,
        string $destination,
        int $status = 302,
        string $method = null,
    ): void {
        if ($method === null) {
            $this->addRoute(Request::ALL_METHODS, $uri, new RedirectController($destination, $status));
        } else {
            $this->addRoute([$method], $uri, new RedirectController($destination, $status));
        }
    }

    /**
     * @return list<Route>
     */
    public function getAllRoutes(): array
    {
        return $this->routes;
    }

    /**
     * @param string[]|string $methods
     * @param object|class-string $controller

The doc comment object|class-string at position 2 could not be parsed: Unknown type name 'class-string' at position 2 in object|class-string.

     */
    private function addRoute(
        array|string $methods,
        string $path,
        object|string $controller,
        string $action = '__invoke',
        ?string $pathPattern = null,
    ): void {
        if (!PathValidator::isValid($path)) {
            throw MalformedPathException::withPath($path);
        }

        if (!is_array($methods)) {

The condition is_array($methods) is always true.

            $methods = [$methods];
        }
        $methods = array_map(static fn ($method) => strtoupper($method), $methods);

        $path = ($path === '/') ? '' : $path;

        foreach ($methods as $method) {
            if (!in_array($method, Request::ALL_METHODS, true)) {
                throw UnsupportedHttpMethodException::withName($method);
            }

            $this->routes[] = new Route($method, $path, $controller, $action, $pathPattern);
        }
    }
}