Subreality\Dilmun\Anshar\Http\Uri

Complexity

Total Complexity

26

Size/Duplication

Total Lines	586
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	9

Test Coverage

Coverage

88.79%

Importance

Changes	10
Bugs	0	Features	0

24 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	8	2
A	getScheme()	0	4	1
A	getAuthority()	0	4	1
A	getUserInfo()	0	4	1
A	getHost()	0	4	1
A	getPort()	0	6	1
A	getParsedUri()	0	4	1
A	getPath()	0	4	1
A	getQuery()	0	4	1
A	getFragment()	0	4	1
A	withScheme()	0	4	1
A	withAuthority()	0	14	1
A	withUserInfo()	0	4	1
A	withHost()	0	4	1
A	withPort()	0	4	1
A	withPath()	0	16	2
A	withQuery()	0	4	1
A	withFragment()	0	4	1
A	__toString()	0	4	1
A	toString()	0	16	1
A	explodeUri()	0	23	1
A	explodeHierParts()	0	20	1
A	parseExplosions()	0	15	1
A	sanitizeUriPartsArray()	0	6	1

<?php
namespace Subreality\Dilmun\Anshar\Http;

use Psr\Http\Message\UriInterface;
use Subreality\Dilmun\Anshar\Http\UriParts\Authority;
use Subreality\Dilmun\Anshar\Http\UriParts\Fragment;
use Subreality\Dilmun\Anshar\Http\UriParts\Host;
use Subreality\Dilmun\Anshar\Http\UriParts\Path;
use Subreality\Dilmun\Anshar\Http\UriParts\Port;
use Subreality\Dilmun\Anshar\Http\UriParts\Query;
use Subreality\Dilmun\Anshar\Http\UriParts\Scheme;
use Subreality\Dilmun\Anshar\Http\UriParts\UserInfo;
use Subreality\Dilmun\Anshar\Utils\ArrayHelper;

/**
 * Class Uri
 * @package Subreality\Dilmun\Anshar\Http
 */
class Uri implements UriInterface
{
    protected $uri_parts = array( //TODO: Probably don't need this anymore; refactor tests and remove

Comments for TODO tasks are often forgotten in the code; it might be better to use a dedicated issue tracker.

        "scheme"    => "",
        "hier_part" => "",
        "authority" => "",
        "user_info" => "",
        "host"      => "",
        "port"      => null,
        "path"      => "",
        "query"     => "",
        "fragment"  => "",
    );

    /** @var  Scheme */
    protected $scheme;
    /** @var  Authority */
    protected $authority;
    /** @var  UserInfo */
    protected $user_info;
    /** @var  Host */
    protected $host;
    /** @var  Port */
    protected $port;
    /** @var  Path */
    protected $path;
    /** @var  Query */
    protected $query;
    /** @var  Fragment */
    protected $fragment;

    protected $sub_delims = array(
        "!",
        "$",
        "&",
        "'",
        "(",
        ")",
        "*",
        "+",
        ",",
        ";",
        "=",
    );

    protected $pchar_unencoded = array(
        ":",
        "@",
    );

    /**
     * Uri constructor.  Accepts a string representing a URI and parses the string into the URI's component parts.
     *
     * @throws \InvalidArgumentException    Throws an \InvalidArgumentException when its parameter is not a string
     * @param string $uri
     */
    public function __construct($uri)
    {
        if (!is_string($uri)) {
            throw new \InvalidArgumentException("New Uri objects must be constructed with a string URI");
        }

        $this->explodeUri($uri);
    }

    /**
     * Retrieve the parsed components of the URI string.
     *
     * If the class was provided an invalid or empty URI string, URI components will be empty strings, except port,
     * which will be null
     *
     * @return mixed[]
     */
    public function getParsedUri()
    {
        return $this->uri_parts;
    }

    /**
     * Retrieve the scheme component of the URI.
     *
     * If no scheme is present, this method MUST return an empty string.
     *
     * The value returned MUST be normalized to lowercase, per RFC 3986
     * Section 3.1.
     *
     * The trailing ":" character is not part of the scheme and MUST NOT be
     * added.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-3.1
     * @return string The URI scheme.
     */
    public function getScheme()
    {
        return (string) $this->scheme;
    }

    /**
     * Retrieve the authority component of the URI.
     *
     * If no authority information is present, this method MUST return an empty
     * string.
     *
     * The authority syntax of the URI is:
     *
     * <pre>
     * [user-info@]host[:port]
     * </pre>
     *
     * If the port component is not set or is the standard port for the current
     * scheme, it SHOULD NOT be included.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-3.2
     * @return string The URI authority, in "[user-info@]host[:port]" format.
     */
    public function getAuthority()
    {
        return $this->user_info->toUriString() . $this->host->toUriString() . $this->port->toUriString($this->scheme);
    }

    /**
     * Retrieve the user information component of the URI.
     *
     * If no user information is present, this method MUST return an empty
     * string.
     *
     * If a user is present in the URI, this will return that value;
     * additionally, if the password is also present, it will be appended to the
     * user value, with a colon (":") separating the values.
     *
     * The trailing "@" character is not part of the user information and MUST
     * NOT be added.
     *
     * @return string The URI user information, in "username[:password]" format.
     */
    public function getUserInfo()
    {
        return (string) $this->user_info;
    }

    /**
     * Retrieve the host component of the URI.
     *
     * If no host is present, this method MUST return an empty string.
     *
     * The value returned MUST be normalized to lowercase, per RFC 3986
     * Section 3.2.2.
     *
     * @see http://tools.ietf.org/html/rfc3986#section-3.2.2
     * @return string The URI host.
     */
    public function getHost()
    {
        return (string) $this->host;
    }

    /**
     * Retrieve the port component of the URI.
     *
     * If a port is present, and it is non-standard for the current scheme,
     * this method MUST return it as an integer. If the port is the standard port
     * used with the current scheme, this method SHOULD return null.
     *
     * If no port is present, and no scheme is present, this method MUST return
     * a null value.
     *
     * If no port is present, but a scheme is present, this method MAY return
     * the standard port for that scheme, but SHOULD return null.
     *
     * @return null|int The URI port.
     */
    public function getPort()
    {
        $normalized_port = $this->port->normalizePortAgainstScheme($this->scheme);

        return $normalized_port;
    }

    /**
     * Retrieve the path component of the URI.
     *
     * The path can either be empty or absolute (starting with a slash) or
     * rootless (not starting with a slash). Implementations MUST support all
     * three syntaxes.
     *
     * Normally, the empty path "" and absolute path "/" are considered equal as
     * defined in RFC 7230 Section 2.7.3. But this method MUST NOT automatically
     * do this normalization because in contexts with a trimmed base path, e.g.
     * the front controller, this difference becomes significant. It's the task
     * of the user to handle both "" and "/".
     *
     * The value returned MUST be percent-encoded, but MUST NOT double-encode
     * any characters. To determine what characters to encode, please refer to
     * RFC 3986, Sections 2 and 3.3.
     *
     * As an example, if the value should include a slash ("/") not intended as
     * delimiter between path segments, that value MUST be passed in encoded
     * form (e.g., "%2F") to the instance.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-2
     * @see https://tools.ietf.org/html/rfc3986#section-3.3
     * @return string The URI path.
     */
    public function getPath()
    {
        return (string) $this->path;
    }

    /**
     * Retrieve the query string of the URI.
     *
     * If no query string is present, this method MUST return an empty string.
     *
     * The leading "?" character is not part of the query and MUST NOT be
     * added.
     *
     * The value returned MUST be percent-encoded, but MUST NOT double-encode
     * any characters. To determine what characters to encode, please refer to
     * RFC 3986, Sections 2 and 3.4.
     *
     * As an example, if a value in a key/value pair of the query string should
     * include an ampersand ("&") not intended as a delimiter between values,
     * that value MUST be passed in encoded form (e.g., "%26") to the instance.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-2
     * @see https://tools.ietf.org/html/rfc3986#section-3.4
     * @return string The URI query string.
     */
    public function getQuery()
    {
        return (string) $this->query;
    }

    /**
     * Retrieve the fragment component of the URI.
     *
     * If no fragment is present, this method MUST return an empty string.
     *
     * The leading "#" character is not part of the fragment and MUST NOT be
     * added.
     *
     * The value returned MUST be percent-encoded, but MUST NOT double-encode
     * any characters. To determine what characters to encode, please refer to
     * RFC 3986, Sections 2 and 3.5.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-2
     * @see https://tools.ietf.org/html/rfc3986#section-3.5
     * @return string The URI fragment.
     */
    public function getFragment()
    {
        return (string) $this->fragment;
    }

    /**
     * Return an instance with the specified scheme.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified scheme.
     *
     * Implementations MUST support the schemes "http" and "https" case
     * insensitively, and MAY accommodate other schemes if required.
     *
     * An empty scheme is equivalent to removing the scheme.
     *
     * @param string $scheme The scheme to use with the new instance.
     * @return static A new instance with the specified scheme.

Should the return type not be Uri|null?

     * @throws \InvalidArgumentException for invalid or unsupported schemes.
     */
    public function withScheme($scheme)
    {
        // TODO: Implement withScheme() method.

Comments for TODO tasks are often forgotten in the code; it might be better to use a dedicated issue tracker.

    }

    /**
     * Return an instance with the specified authority.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified authority.
     *
     * Replacing the authority is equivalent to replacing or removing all authority components depending upon the
     * composition of the authority.
     *
     * An empty authority is equivalent to removing the authority and all authority components.
     *
     * @param string $authority The scheme to use with the new instance.
     * @return static A new instance with the specified authority.
     * @throws \InvalidArgumentException for invalid authorities.
     */
    public function withAuthority($authority)
    {
        $with_authority = new Authority($authority);

        $new_authority_uri = clone $this;

        $new_authority_uri->authority = $with_authority;

        $new_authority_uri->user_info = $with_authority->getUserInfo();
        $new_authority_uri->host      = $with_authority->getHost();
        $new_authority_uri->port      = $with_authority->getPort();

        return $new_authority_uri;
    }

    /**
     * Return an instance with the specified user information.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified user information.
     *
     * Password is optional, but the user information MUST include the
     * user; an empty string for the user is equivalent to removing user
     * information.
     *
     * @param string $user The user name to use for authority.
     * @param null|string $password The password associated with $user.
     * @return static A new instance with the specified user information.

Should the return type not be Uri|null?

     */
    public function withUserInfo($user, $password = null)
    {
        // TODO: Implement withUserInfo() method.

Comments for TODO tasks are often forgotten in the code; it might be better to use a dedicated issue tracker.

    }

    /**
     * Return an instance with the specified host.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified host.
     *
     * An empty host value is equivalent to removing the host.
     *
     * @param string $host The hostname to use with the new instance.
     * @return static A new instance with the specified host.

Should the return type not be Uri|null?

     * @throws \InvalidArgumentException for invalid hostnames.
     */
    public function withHost($host)
    {
        // TODO: Implement withHost() method.

Comments for TODO tasks are often forgotten in the code; it might be better to use a dedicated issue tracker.

    }

    /**
     * Return an instance with the specified port.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified port.
     *
     * Implementations MUST raise an exception for ports outside the
     * established TCP and UDP port ranges.
     *
     * A null value provided for the port is equivalent to removing the port
     * information.
     *
     * @param null|int $port The port to use with the new instance; a null value
     *     removes the port information.
     * @return static A new instance with the specified port.

Should the return type not be Uri|null?

     * @throws \InvalidArgumentException for invalid ports.
     */
    public function withPort($port)
    {
        // TODO: Implement withPort() method.

Comments for TODO tasks are often forgotten in the code; it might be better to use a dedicated issue tracker.

    }

    /**
     * Return an instance with the specified path.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified path.
     *
     * The path can either be empty or absolute (starting with a slash) or
     * rootless (not starting with a slash). Implementations MUST support all
     * three syntaxes.
     *
     * If the path is intended to be domain-relative rather than path relative then
     * it must begin with a slash ("/"). Paths not starting with a slash ("/")
     * are assumed to be relative to some base path known to the application or
     * consumer.
     *
     * Users can provide both encoded and decoded path characters.
     * Implementations ensure the correct encoding as outlined in getPath().
     *
     * @throws \InvalidArgumentException for invalid paths and invalid path/authority combinations.
     *
     * @param string $path The path to use with the new instance.
     * @return static A new instance with the specified path.
     */
    public function withPath($path)
    {
        if (!Path::validatePathAgainstAuthority($path, $this->authority)) {
            throw new \InvalidArgumentException("Cannot create a URI with an authority given a rootless path");
        }

        $with_path = new Path($path);

        $new_path_uri = clone $this;

        $new_path_uri->path = $with_path;

        $new_path_uri->uri_parts["path"] = $path;

        return $new_path_uri;
    }

    /**
     * Return an instance with the specified query string.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified query string.
     *
     * Users can provide both encoded and decoded query characters.
     * Implementations ensure the correct encoding as outlined in getQuery().
     *
     * An empty query string value is equivalent to removing the query string.
     *
     * @param string $query The query string to use with the new instance.
     * @return static A new instance with the specified query string.

Should the return type not be Uri|null?

     * @throws \InvalidArgumentException for invalid query strings.
     */
    public function withQuery($query)
    {
        // TODO: Implement withQuery() method.

Comments for TODO tasks are often forgotten in the code; it might be better to use a dedicated issue tracker.

    }

    /**
     * Return an instance with the specified URI fragment.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified URI fragment.
     *
     * Users can provide both encoded and decoded fragment characters.
     * Implementations ensure the correct encoding as outlined in getFragment().
     *
     * An empty fragment value is equivalent to removing the fragment.
     *
     * @param string $fragment The fragment to use with the new instance.
     * @return static A new instance with the specified fragment.

Should the return type not be Uri|null?

     */
    public function withFragment($fragment)
    {
        // TODO: Implement withFragment() method.

Comments for TODO tasks are often forgotten in the code; it might be better to use a dedicated issue tracker.

    }

    /**
     * Return the string representation as a URI reference.
     *
     * Depending on which components of the URI are present, the resulting
     * string is either a full URI or relative reference according to RFC 3986,
     * Section 4.1. The method concatenates the various components of the URI,
     * using the appropriate delimiters:
     *
     * - If a scheme is present, it MUST be suffixed by ":".
     * - If an authority is present, it MUST be prefixed by "//".
     * - The path can be concatenated without delimiters. But there are two
     *   cases where the path has to be adjusted to make the URI reference
     *   valid as PHP does not allow to throw an exception in __toString():
     *     - If the path is rootless and an authority is present, the path MUST
     *       be prefixed by "/".
     *     - If the path is starting with more than one "/" and no authority is
     *       present, the starting slashes MUST be reduced to one.
     * - If a query is present, it MUST be prefixed by "?".
     * - If a fragment is present, it MUST be prefixed by "#".
     *
     * @see http://tools.ietf.org/html/rfc3986#section-4.1
     * @return string
     */
    public function __toString()
    {
        return $this->toString();
    }

    /**
     * Converts a given array of URI parts to a string according to the specification of the __toString magic method
     *
     * @see Uri::__toString
     *
     * @return string           The string combined from the array of URI parts
     */
    private function toString()
    {
        $uri_string = "";

        $uri_string .= $this->scheme->toUriString();

        $uri_string .= $this->authority->toUriString($this->scheme);

        $uri_string .= $this->path->toUriString($this->authority);

        $uri_string .= $this->query->toUriString();

        $uri_string .= $this->fragment->toUriString();

        return $uri_string;
    }

    /**
     * Splits a string URI into its component parts, returning true if the URI string matches a valid URI's syntax
     * and false if the URI string does not
     *
     * @param string $uri   The URI string to be decomposed
     * @return bool         Returns true if the URI string matches a valid URI's syntax
     *                      Returns false otherwise
     */
    private function explodeUri($uri)
    {
        $reg_start     = '/^';
        $scheme_part   = '(?:(?\'scheme\'[A-Za-z0-9][^\/\?#:]+):)?';
        $hier_part     = '(?\'hier_part\'[^\?#]+)?';
        $query_part    = '(?:\?(?\'query\'[^#]*))?';
        $fragment_part = '(?:#(?\'fragment\'.*))?';
        $reg_end       = '/';

        $uri_syntax = $reg_start . $scheme_part . $hier_part . $query_part . $fragment_part . $reg_end;

        $uri_valid = preg_match($uri_syntax, $uri, $parts);

        $this->uri_parts = array_merge($this->uri_parts, $parts); //overwriting default values with matches

        $this->explodeHierParts($this->uri_parts["hier_part"]);

        $this->parseExplosions();

        $this->sanitizeUriPartsArray();

        return (bool) $uri_valid;
    }

    /**
     * Splits URI hierarchy data into authority and path data.
     *
     * @param string $hier_part     The hierarchy part of a URI to be decomposed
     * @return void
     */
    private function explodeHierParts($hier_part)
    {
        $hier_parts = array(
            "authority" => "",
            "path"      => "",
        );

        $reg_start      = '/^';
        $authority_part = '(?:(?:\/\/)(?\'authority\'.[^\/]+))?';
        $path_part      = '(?\'path\'.+)?';
        $reg_end        = '/';

        $hier_part_syntax = $reg_start . $authority_part . $path_part . $reg_end;

        preg_match($hier_part_syntax, $hier_part, $matches);

        $hier_parts = array_merge($hier_parts, $matches);

        $this->uri_parts = array_merge($this->uri_parts, $hier_parts);
    }

    /**
     * Parses the results of exploding URI parts.  Creates component objects and fills in uri_parts array with
     * sub-component data.
     *
     * @return void
     */
    private function parseExplosions()
    {
        $this->scheme    = new Scheme($this->uri_parts["scheme"]);
        $this->query     = new Query($this->uri_parts["query"]);
        $this->fragment  = new Fragment($this->uri_parts["fragment"]);
        $this->authority = new Authority($this->uri_parts["authority"]);
        $this->user_info = $this->authority->getUserInfo();
        $this->host      = $this->authority->getHost();
        $this->port      = $this->authority->getPort();
        $this->path      = new Path($this->uri_parts["path"]);

        $this->uri_parts["user_info"] = (string) $this->user_info;
        $this->uri_parts["host"]      = (string) $this->host;
        $this->uri_parts["port"]      = $this->port->getPort();
    }

    /**
     * Sanitizes the URI component array by removing redundant key/value pairs
     *
     * @return void
     */
    private function sanitizeUriPartsArray()
    {
        $uri_part_array = new ArrayHelper($this->uri_parts);

        $this->uri_parts = $uri_part_array->removeNumericKeys();
    }
}