Static method which either returns a reference to the global JURI object, only creating it if it doesn't already exist, or which creates a new object representing the URI passed to it as a parameter. The global URI object represents the URI that caused the current page to be rendered.


object &getInstance( $uri )


Argument Data type Description Default
$uri string URI to be represented by the JURI object. If this is 'SERVER' then the request URI is assumed. 'SERVER'

Example 1

In this example, a URI object is created and then converted back to string form.

$uri = '';
$u =& JURI::getInstance( $uri );
echo 'URI is ' . $u->toString() . "\n";

would output

URI is

Example 2

To obtain the current request URI this method can be called with no arguments. This has the same effect as calling JFactory::getURI().

$u =& JURI::getInstance();
echo 'Request URI is ' . $u->toString() . "\n";

might output

Request URI is http://localhost/joomla/index.php?option=com_content&view=article&id=1&Itemid=50

See also