Joomla! API

Download
Launch

UriImmutable

Extends AbstractUri

UriImmutable Class

final

This is an immutable version of the AbstractUri class.

since

1.0
package

Joomla Framework

Methods

__construct

This is a special constructor that prevents calling the __construct method again.

__construct( uri = null) :
since

1.0
throws

BadMethodCallException

Arguments

uri

stringThe optional URI string

Response

mixed

__set

Prevent setting undeclared properties.

__set( name,  value) :
since

1.0
throws

BadMethodCallException

Arguments

name

stringThis is an immutable object, setting $name is not allowed.

value

mixedThis is an immutable object, setting $value is not allowed.

Response

voidThis method always throws an exception.

__toString

Magic method to get the string representation of the UriInterface object.

__toString() :
inherited
since

1.0

Response

string

buildQuery

Build a query from an array (reverse of the PHP parse_str()).

buildQuery(mixed||string|int params) :
inherited static
see parse_str()
since

1.0

Arguments

params

array<string|int, mixed>The array of key => value pairs to return as a query string.

Response

stringThe resulting query string.

cleanPath

Resolves //, ../ and ./ from a path and returns the result.

cleanPath( path) :
inherited

For example: /foo/bar/../boo.php => /foo/boo.php /foo/bar/../../boo.php => /boo.php /foo/bar/.././/boo.php => /foo/boo.php

since

1.0

Arguments

path

stringThe URI path to clean.

Response

stringCleaned and resolved URI path.

getFragment

Get the URI anchor string

getFragment() :
inherited
since

1.0

Response

stringThe URI anchor string.

getHost

Get the URI host

getHost() :
inherited
since

1.0

Response

stringThe hostname/IP or null if no hostname/IP was specified.

getPass

Get the URI password

getPass() :
inherited
since

1.0

Response

stringThe password, or null if no password was specified.

getPath

Gets the URI path string

getPath() :
inherited
since

1.0

Response

stringThe URI path string.

getPort

Get the URI port

getPort() :
inherited
since

1.0

Response

intThe port number, or null if no port was specified.

getQuery

Returns flat query string.

getQuery( toArray = false) : string|array
inherited
since

1.0

Arguments

toArray

boolTrue to return the query as a key => value pair array.

Response

string|array<string|int, mixed>Query string or Array of parts in query string depending on the function param

getScheme

Get the URI scheme (protocol)

getScheme() :
inherited
since

1.0

Response

stringThe URI scheme.

getUser

Get the URI username

getUser() :
inherited
since

1.0

Response

stringThe username, or null if no username was specified.

getVar

Returns a query variable by name.

getVar( name,  default = null) :
inherited
since

1.0

Arguments

name

stringName of the query variable to get.

default

stringDefault value to return if the variable is not set.

Response

mixedRequested query variable if present otherwise the default value.

hasVar

Checks if variable exists.

hasVar( name) :
inherited
since

1.0

Arguments

name

stringName of the query variable to check.

Response

boolTrue if the variable exists.

isSsl

Checks whether the current URI is using HTTPS.

isSsl() :
inherited
since

1.0

Response

boolTrue if using SSL via HTTPS.

parse

Parse a given URI and populate the class fields.

parse( uri) :
inherited
since

1.0

Arguments

uri

stringThe URI string to parse.

Response

boolTrue on success.

render

Returns full uri string.

render( parts = self::ALL) :
inherited
since

1.2.0

Arguments

parts

intA bitmask specifying the parts to render.

Response

stringThe rendered URI string.

toString

Returns full URI string.

toString(mixed||string|int parts = ['scheme', 'user', 'pass', 'host', 'port', 'path', 'query', 'fragment']) :
inherited
since

1.0

Arguments

parts

array<string|int, mixed>An array of strings specifying the parts to render.

Response

stringThe rendered URI string.

Properties

uri

Original URI

inherited
since

1.0

Type(s)

string

scheme

Protocol

inherited
since

1.0

Type(s)

string

host

Host

inherited
since

1.0

Type(s)

string

port

Port

inherited
since

1.0

Type(s)

int

user

Username

inherited
since

1.0

Type(s)

string

pass

Password

inherited
since

1.0

Type(s)

string

path

Path

inherited
since

1.0

Type(s)

string

query

Query

inherited
since

1.0

Type(s)

string|null

fragment

Anchor

inherited
since

1.0

Type(s)

string

vars

Query variable hash

inherited
since

1.0

Type(s)

array<string|int, mixed>

constructed

Flag if the class been instantiated

since

1.0

Type(s)

bool
  • \ Joomla
  • \ Uri
  • \ UriImmutable