Joomla! API

Download
Launch

Uri

Extends AbstractUri

Uri Class

This class parses a URI and provides a common interface for the Joomla Framework to access and manipulate a URI.

since

1.0
package

Joomla Framework

Methods

__construct

Constructor.

__construct(string uri = null) : mixed
inherited

You can pass a URI string to the constructor to initialise a specific URI.

since

1.0

Arguments

uri

stringThe optional URI string

Response

mixed

__toString

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

__toString() : string
inherited
since

1.0

Response

string

buildQuery

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

buildQuery(array params) : string
inherited static
see parse_str()
since

1.0

Arguments

params

arrayThe 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(string path) : string
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.

delVar

Removes an item from the query string variables if it exists

delVar(string name) : void
since

1.0

Arguments

name

stringName of variable to remove.

getFragment

Get the URI anchor string

getFragment() : string
inherited
since

1.0

Response

stringThe URI anchor string.

getHost

Get the URI host

getHost() : string
inherited
since

1.0

Response

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

getPass

Get the URI password

getPass() : string
inherited
since

1.0

Response

stringThe password, or null if no password was specified.

getPath

Gets the URI path string

getPath() : string
inherited
since

1.0

Response

stringThe URI path string.

getPort

Get the URI port

getPort() : int
inherited
since

1.0

Response

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

getQuery

Returns flat query string.

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

1.0

Arguments

toArray

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

Response

string|arrayQuery string or Array of parts in query string depending on the function param

getScheme

Get the URI scheme (protocol)

getScheme() : string
inherited
since

1.0

Response

stringThe URI scheme.

getUser

Get the URI username

getUser() : string
inherited
since

1.0

Response

stringThe username, or null if no username was specified.

getVar

Returns a query variable by name.

getVar(string name, string default = null) : mixed
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(string name) : bool
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() : bool
inherited
since

1.0

Response

boolTrue if using SSL via HTTPS.

parse

Parse a given URI and populate the class fields.

parse(string uri) : bool
inherited
since

1.0

Arguments

uri

stringThe URI string to parse.

Response

boolTrue on success.

render

Returns full uri string.

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

1.2.0

Arguments

parts

intA bitmask specifying the parts to render.

Response

stringThe rendered URI string.

setFragment

Set the URI anchor string

setFragment(string anchor) : \Joomla\Uri\Uri
since

1.0

Arguments

anchor

stringThe URI anchor string.

Response

\Joomla\Uri\UriThis method supports chaining.

setHost

Set the URI host

setHost(string host) : \Joomla\Uri\Uri
since

1.0

Arguments

host

stringThe URI host.

Response

\Joomla\Uri\UriThis method supports chaining.

setPass

Set the URI password

setPass(string pass) : \Joomla\Uri\Uri
since

1.0

Arguments

pass

stringThe URI password.

Response

\Joomla\Uri\UriThis method supports chaining.

setPath

Set the URI path string

setPath(string path) : \Joomla\Uri\Uri
since

1.0

Arguments

path

stringThe URI path string.

Response

\Joomla\Uri\UriThis method supports chaining.

setPort

Set the URI port

setPort(int port) : \Joomla\Uri\Uri
since

1.0

Arguments

port

intThe URI port number.

Response

\Joomla\Uri\UriThis method supports chaining.

setQuery

Sets the query to a supplied string in format foo=bar&x=y

setQuery(array|string query) : void
since

1.0

Arguments

query

array|stringThe query string or array.

setScheme

Set the URI scheme (protocol)

setScheme(string scheme) : \Joomla\Uri\Uri
since

1.0

Arguments

scheme

stringThe URI scheme.

Response

\Joomla\Uri\UriThis method supports chaining.

setUser

Set the URI username

setUser(string user) : \Joomla\Uri\Uri
since

1.0

Arguments

user

stringThe URI username.

Response

\Joomla\Uri\UriThis method supports chaining.

setVar

Adds a query variable and value, replacing the value if it already exists and returning the old value

setVar(string name, string value) : string
since

1.0

Arguments

name

stringName of the query variable to set.

value

stringValue of the query variable.

Response

stringPrevious value for the query variable.

toString

Returns full URI string.

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

1.0

Arguments

parts

arrayAn 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

fragment

Anchor

inherited
since

1.0

Type(s)

string

vars

Query variable hash

inherited
since

1.0

Type(s)

array
  • \ Joomla
  • \ Uri
  • \ Uri