API15

API15:JURI/root

From Joomla! Documentation

Revision as of 22:20, 22 March 2010 by Doxiki (talk | contribs) (New page: ===Description=== Returns the root URI for the request. <span class="editsection" style="font-size:76%;"> <nowiki>[</nowiki>Edit Descripton<nowiki>]</nowiki>...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Description

Returns the root URI for the request.

[Edit Descripton]

Template:Description:JURI/root

Syntax

root($pathonly=false, $path=null)
Parameter Name Default Value Description
$pathonly false $pathonly If false, prepend the scheme, host and port information. Default is false.
$path null

Returns

string The root URI string

Defined in

libraries/joomla/environment/uri.php

Importing

jimport( 'joomla.environment.uri' );

Source Body

function root($pathonly = false, $path = null)
{
        static $root;

        // Get the scheme
        if(!isset($root))
        {
                $uri            =& JURI::getInstance(JURI::base());
                $root['prefix'] = $uri->toString( array('scheme', 'host', 'port') );
                $root['path']   = rtrim($uri->toString( array('path') ), '/\\');
        }

        // Get the scheme
        if(isset($path)) {
                $root['path']    = $path;
        }

        return $pathonly === false ? $root['prefix'].$root['path'].'/' : $root['path'];
}

[Edit See Also] Template:SeeAlso:JURI/root

Examples

<CodeExamplesForm />