Uri

Returns the scheme component of the URI.

Note that the returned value will always be normalized to lowercase, as per RFC 3986 Section 3.1. If no scheme has been provided, an empty string will be returned instead.

Returns the standard port for the current scheme.

The known ports are:

• ftp : 21
• http : 80
• https : 443

Returns the user information component of the URI.

The user information component contains the username and password in the URI separated by a colon. If no username has been provided, an empty string will be returned instead. If no password has been provided, the returned value will only contain the username without the delimiting colon.

Returns the decoded username from the URI.

Returns the decoded password from the URI.

Returns the host component of the URI.

Note that the returned value will always be normalized to lowercase, as per RFC 3986 Section 3.2.2. If no host has been provided, an empty string will be returned instead.

Returns the IP address from the host component.

Returns the top level domain from the host component.

Note that if the host component represents an IP address, an empty string will be returned instead. Additionally, if the host component ends in a period, the section prior that period will be returned instead. If no period is present in the host component, the entire host component will be returned.

Returns the path component of the URI.

Returns the decoded path segments from the path component.

Returns the file extension for the last segment in the path.

Returns the query string of the URI.

Returns the decoded parameters parsed from the query component.

Returns a URI instance with the specified path.

The provided path may or may not begin with a forward slash. The path will be automatically normalized with the appropriate number of slashes once the string is generated from the Uri instance. An empty string can be used to remove the path. The path may also contain percent encoded characters as these characters will not be double encoded.

Returns a URI instance with path constructed from given path segments.

Note that all the segments are assumed to be decoded. Thus any percent encoded characters in the segments will be double encoded. Due to aggressive encoding, this method will encode even the forward slashes in the provided segments.

Returns a URI instance with the specified query string.

An empty string can be used to remove the query string. The provided value may contain both encoded and unencoded characters. Encoded characters will not be double encoded.

Returns a URI instance with the query constructed from the given parameters.

The provided associative array will be used to construct the query string. Even characters such as the ampersand and equal sign will be encoded in resulting string. Note the any percent encoded characters will be double encoded, since this method assumes that all the values are unencoded.

Creates a new instance of Uri.

Returns the authority component of the URI.

If no authority information has been provided, an empty string will be returned instead. Note that the host component in the authority component will always be normalized to lowercase as per RFC 3986 Section 3.2.2.

Also note that even if a port has been provided, but it is the standard port for the current scheme, the port will not be included in the returned value.

The format of the returned value is [user-info@]host[:port]

Returns the port component of the URI.

If no port has been provided, this method will return a null instead. Note that this method will also return a null, if the provided port is the standard port for the current scheme.

Returns the fragment component of the URI.

Returns a URI instance with the specified scheme.

This method allows all different kinds of schemes. Note, however, that the different components are only validated based on the generic URI syntax. No additional validation is performed based on the scheme. An empty string can be used to remove the scheme. Note that the provided scheme will be normalized to lowercase.

Returns a URI instance with the specified user information.

Note that the password is optional, but unless an username is provided, the password will be ignored. Note that this method assumes that neither the username nor the password contains encoded characters. Thus, all encoded characters will be double encoded, if present. An empty username can be used to remove the user information.

Returns a URI instance with the specified host.

An empty host can be used to remove the host. Note that since host names are treated in a case insensitive manner, the host will be normalized to lowercase. This method does not support international domain names and hosts with non ascii characters are considered invalid.

Returns a URI instance with the specified port.

A null value can be used to remove the port number. Note that if an invalid port number is provided (a number less than 0 or more than 65535), an exception will be thrown.

Returns a URI instance with the specified URI fragment.

An empty string can be used to remove the fragment. The provided value may contain both encoded and unencoded characters. Encoded characters will not be double encoded.

Returns the string representation of the URI.

The resulting URI will be composed of the provided components. All components that have not been provided will be omitted from the generated URI. The provided path will be normalized based on whether the authority is included in the URI or not.