Uri.php

<?php

declare(strict_types=1);

namespace SonsOfPHP\Component\HttpMessage;

use Psr\Http\Message\UriInterface;
use Stringable;

/**
 * {@inheritdoc}
 *
 * @author Joshua Estes <joshua@sonsofphp.com>
 */
class Uri implements UriInterface, Stringable
{
    private string $scheme;

    private string $host;

    private ?string $path = null;

    private ?int $port = null;

    private ?string $user = null;

    private ?string $password = null;

    private ?string $fragment = null;

    private array $queryParams = [];

    public function __construct(
        string $uri = '',
    ) {
        if ('' !== $uri) {
            $parts = parse_url($uri);

            $this->scheme   = isset($parts['scheme']) ? strtolower($parts['scheme']) : '';
            $this->user     = $parts['user'] ?? null;
            $this->password = $parts['pass'] ?? null;
            $this->host     = isset($parts['host']) ? strtolower($parts['host']) : '';
            $this->port     = $parts['port'] ?? null;
            $this->path     = $parts['path'] ?? null;
            $this->fragment = $parts['fragment'] ?? null;

            if (isset($parts['query']) && ($parts['query'] !== '' && $parts['query'] !== '0')) {
                parse_str($parts['query'], $this->queryParams);
            }
        }
    }

    /**
     * {@inheritdoc}
     */
    public function getScheme(): string
    {
        return $this->scheme;
    }

    /**
     * {@inheritdoc}
     */
    public function getAuthority(): string
    {
        $authority = $this->getHost();
        if ('' !== $userInfo = $this->getUserInfo()) {
            $authority = $this->getUserInfo() . '@' . $authority;
        }

        if (null !== $this->port) {
            return $authority . ':' . $this->port;
        }

        return $authority;
    }

    /**
     * {@inheritdoc}
     */
    public function getUserInfo(): string
    {
        if (null === $this->user && null === $this->password) {
            return '';
        }

        return trim($this->user . ':' . $this->password, ':');
    }

    /**
     * {@inheritdoc}
     */
    public function getHost(): string
    {
        return $this->host;
    }

    /**
     * {@inheritdoc}
     */
    public function getPort(): ?int
    {
        if (null !== $this->port) {
            return $this->port;
        }

        return match ($this->getScheme()) {
            'http' => 80,
            'https' => 443,
            default => null,
        };
    }

    /**
     * {@inheritdoc}
     */
    public function getPath(): string
    {
        return $this->path ?? '';
    }

    /**
     * {@inheritdoc}
     */
    public function getQuery(): string
    {
        //return http_build_query($this->queryParams, '', null, \PHP_QUERY_RFC3986);

        $query = '';
        foreach ($this->queryParams as $key => $value) {
            if (is_array($value)) {
                foreach ($value as $n => $v) {
                    $query .= sprintf('&%s[%s]', $key, $n);
                    if (!empty($v)) {
                        $query .= '=' . rawurlencode((string) $v);
                    }
                }

                continue;
            }

            $query .= '&' . $key;

            // null or ''
            if (!empty($value)) {
                $query .= '=' . rawurlencode((string) $value);
                continue;
            }
        }

        return ltrim($query, '&');
    }

    /**
     * {@inheritdoc}
     */
    public function getFragment(): string
    {
        return $this->fragment ?? '';
    }

    /**
     * {@inheritdoc}
     */
    public function withScheme(string $scheme): UriInterface
    {
        $scheme = strtolower($scheme);

        if ($scheme === $this->scheme) {
            return $this;
        }

        $that = clone $this;

        $that->scheme = $scheme;

        return $that;
    }

    /**
     * {@inheritdoc}
     */
    public function withUserInfo(string $user, ?string $password = null): UriInterface
    {
        if ($user === $this->user && $password === $this->password) {
            return $this;
        }

        $that = clone $this;

        $that->user     = $user;
        $that->password = $password;

        return $that;
    }

    /**
     * {@inheritdoc}
     */
    public function withHost(string $host): UriInterface
    {
        $host = strtolower($host);

        if ($host === $this->host) {
            return $this;
        }

        $that = clone $this;

        $that->host = $host;

        return $that;
    }

    /**
     * {@inheritdoc}
     */
    public function withPort(?int $port): UriInterface
    {
        if ($port === $this->getPort()) {
            return $this;
        }

        $that = clone $this;

        $that->port = $port;

        return $that;
    }

    /**
     * {@inheritdoc}
     */
    public function withPath(string $path): UriInterface
    {
        if ($path === $this->getPath()) {
            return $this;
        }

        $that = clone $this;

        $that->path = $path;

        return $that;
    }

    /**
     * {@inheritdoc}
     */
    public function withQuery(string $query): UriInterface
    {
        if ($query === $this->getQuery()) {
            return $this;
        }

        parse_str($query, $output);

        $that = clone $this;

        //$that->query = $query;
        $that->queryParams = $output;

        return $that;
    }

    /**
     * {@inheritdoc}
     */
    public function withFragment(string $fragment): UriInterface
    {
        $fragment = ltrim($fragment, '#');
        if ($fragment === $this->getFragment()) {
            return $this;
        }

        $that = clone $this;

        $that->fragment = $fragment;

        return $that;
    }

    /**
     * {@inheritdoc}
     */
    public function __toString(): string
    {
        return ($this->scheme !== '' && $this->scheme !== '0' ? $this->scheme . '://' : '') .
            ($this->getUserInfo() !== '' && $this->getUserInfo() !== '0' ? $this->getUserInfo() . '@' : '') .
            ($this->getHost()) .
            ($this->port !== null && $this->port !== 0 ? ':' . $this->port : '') .
            ($this->getPath() ?? '') .
            ($this->getQuery() !== '' && $this->getQuery() !== '0' ? '?' . $this->getQuery() : '') .
            ($this->getFragment() !== '' && $this->getFragment() !== '0' ? '#' . $this->getFragment() : '')
        ;
    }

    /**
     * Example:
     *   ->withQueryParams([
     *      'query' => 'search string',
     *      'page' => '1',
     *      'limit' => '10',
     *      'filters' => [
     *          'active' => '1',
     *      ],
     *   ]);
     *   ?query=search%20string&page=1&limit=10&filters[active]=1
     */
    public function withQueryParams(?array $params): static
    {
        $that = clone $this;

        if (null === $params) {
            $that->queryParams = [];
            return $that;
        }

        $that->queryParams += $params;

        return $that;
    }

    /**
     * Examples
     *   ->withQueryParam('page', 1);
     *   ?page=1
     */
    public function withQueryParam(string $name, int|string|array $value): static
    {
        $that = clone $this;

        $that->queryParams[$name] = $value;

        return $that;
    }
}