JURI - Revision history

Hutchy68: just testing some template changes with layout

2012-11-30T20:43:23Z

just testing some template changes with layout

JoomlaWikiBot: re-categorisation

2012-08-09T18:15:37Z

re-categorisation

JoomlaWikiBot: re-categorisation

2012-08-09T16:32:02Z

re-categorisation

Doxiki2: Updated to r1448:247ba8d88526

2011-04-27T23:24:25Z

Updated to r1448:247ba8d88526

Doxiki2: Layout updates

2011-04-25T23:22:47Z

Layout updates

Doxiki2: Bulk upload by Doxiki2

2011-04-20T21:13:40Z

Bulk upload by Doxiki2

Doxiki2: Bulk upload by Doxiki2

2011-04-17T21:32:02Z

Bulk upload by Doxiki2

Show changes

Chris Davenport: Added availability section.

2009-07-03T22:46:16Z

Added availability section.

Chris Davenport at 21:54, 16 September 2008

2008-09-16T21:54:04Z

Chris Davenport: New page: '''JURI''' provides a number of methods and properties for handling Uniform Resource Identifiers (URIs). It also provides a means of obtaining the URI of the current request regardless of...

2008-09-10T20:44:15Z

New page: '''JURI''' provides a number of methods and properties for handling Uniform Resource Identifiers (URIs). It also provides a means of obtaining the URI of the current request regardless of...

New page

'''JURI''' provides a number of methods and properties for handling Uniform Resource Identifiers (URIs). It also provides a means of obtaining the URI of the current request regardless of the web server on which Joomla is running.

The formal structure of a URI is defined in [http://gbiv.com/protocols/uri/rfc/rfc3986.html RFC3986] and the following is an example taken from that document:
foo://example.com:8042/over/there?name=ferret#nose
\_/ \______________/\_________/ \_________/ \__/
| | | | |
scheme authority path query fragment

The scheme and path components are required, though the path may be empty (no characters). When authority is present, the path must either be empty or begin with a slash ("/") character. When authority is not present, the path cannot begin with two slash characters ("//").

The scheme usually specifies the internet protocol that is to be used to access the resource. For example, 'http' indicates that the HyperText Transfer Protocol is to be used.

The authority field can be sub-divided into user information, host and port number parts. The user information part allows a URI to contain authentication information, usually in the form 'username:password', although this format is deprecated as "The passing of authentication information in clear text has proven to be a security risk in almost every case where it has been used." However, as URIs containing authentication information are still available on the internet, the JURI class will continue to support the generation and parsing of user authentication information.

The query part may contain multiple items, separated by '&' characters.

The JURI class effectively provides a wrapper around the PHP [http://www.php.net/manual/en/function.parse-url.php parse_url] function.

===Defined in===
/libraries/joomla/environment/uri.php

===Extends===
* [[JObject]]

===Get and Set Methods===
Get and set methods are provided for all the component parts of a URI. The following names of the component parts are used:
http://fredbloggs:itsasecret@www.example.com:8080/path/to/Joomla/index.php?task=view&id=32#anchorthis
\__/ \________/ \________/ \_____________/ \__/\_______________________/ \_____________/ \________/
| | | | | | | |
scheme user pass host port path query fragment

The example column in the following table illustrates the result of each of the get methods on the URI above.
{| class="wikitable"
|-
!Get method
!Set method
!Description
!Example
|-
|[[JURI/getFragment|getFragment]]
|[[JURI/setFragment|setFragment]]
|Fragment (everything after the '#'). This is often referred to as an anchor.
|anchorthis
|-
|[[JURI/getHost|getHost]]
|[[JURI/setHost|setHost]]
|Hostname or IP address. For example, 'www.joomla.org' or '192.168.2.45'.
|www.example.com
|-
|[[JURI/getPass|getPass]]
|[[JURI/setPass|setPass]]
|Password part of the authority.
|itsasecret
|-
|[[JURI/getPath|getPath]]
|[[JURI/setPath|setPath]]
|Path string. Note that the path always includes the leading "/" character.
|/path/to/Joomla/index.php
|-
|[[JURI/getPort|getPort]]
|[[JURI/setPort|setPort]]
|Port number. Specific schemes (protocols) have their own defaults (for example, 'http' is port 80, 'ftp' is port 21).
|8080
|-
|[[JURI/getQuery|getQuery]]
|[[JURI/setQuery|setQuery]]
|Query in string format. For example, "foo=bar&x=y". See also [[JURI/buildQuery|buildQuery]].
|task=view&id=32
|-
|[[JURI/getScheme|getScheme]]
|[[JURI/setScheme|setScheme]]
|Scheme (protocol). For example, 'http', 'https', 'ftp'.
|http
|-
|[[JURI/getUser|getUser]]
|[[JURI/setUser|setUser]]
|Username part of the authority.
|fredbloggs
|-
|[[JURI/getVar|getVar]]
|[[JURI/setVar|setVar]]
|An individual query item value from within the query part. See also [[JURI/delVar|delVar]].
|32
|}

===Other Methods===
{| class="wikitable"
|-
!Method name
!Description
|-
|[[JURI/base|base]]
|Returns the base URI of the request, regardless of the URI object.
|-
|[[JURI/buildQuery|buildQuery]]
|Build query from an array.
|-
|[[JURI/current|current]]
|Returns the current URI of the request without the query part, regardless of the URI object.
|-
|[[JURI/delVar|delVar]]
|Removes an individual query item. See also [[JURI/getVar|getVar]] and [[JURI/setVar|setVar]].
|-
|[[JURI/getInstance|getInstance]]
|Returns a reference to the global JURI object, only creating it if it doesn't already exist. This is the URI that caused the current page to be rendered.
|-
|[[JURI/isInternal|isInternal]]
|Checks whether the URI is internal; that is, on the same host as Joomla.
|-
|[[JURI/isSSL|isSSL]]
|Checks whether the URI is using the 'https' scheme (protocol).
|-
|[[JURI/parse|parse]]
|Parse the URI and populate the class fields.
|-
|[[JURI/root|root]]
|Returns the root URI of the request, regardless of the URI object.
|-
|[[JURI/toString|toString]]
|Returns the full URI represented by the URI object in string format.
|}
===Importing===
<source lang="php">jimport( 'joomla.environment.uri' );</source>

===See also===
* [http://api.joomla.org/Joomla-Framework/Environment/JURI.html JURI on api.joomla.org]
* [http://gbiv.com/protocols/uri/rfc/rfc3986.html RFC3986: Uniform Resource Identifier (URI): Generic Syntax]
* [http://www.php.net/manual/en/function.parse-url.php PHP parse_url function]
* [[JFactory/getURI|JFactory::getURI]]
* [[JRoute]]
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JURI]]</noinclude>

@@ Line 1: / Line 1: @@
-This class is available in the following Joomla versions:-
+{{splist||page=landing}}
-<splist showpath=notparent />
+{{JNav|JURI Methods}}
 <noinclude>[[Category:JURI]][[Category:JURI Methods]]</noinclude>

@@ Line 1: / Line 1: @@
 This class is available in the following Joomla versions:-
 <splist showpath=notparent />
-<noinclude>[[Category:JURI]]</noinclude>
+<noinclude>[[Category:JURI]][[Category:JURI Methods]]</noinclude>

@@ Line 1: / Line 1: @@
 This class is available in the following Joomla versions:-
 <splist showpath=notparent />
-<noinclude>[[Category:Platform]][[Category:JURI]]</noinclude>
+<noinclude>[[Category:JURI]]</noinclude>

@@ Line 1: / Line 1: @@
 This class is available in the following Joomla versions:-
 <splist showpath=notparent />
-<noinclude>[[Category:Framework]][[Category:JURI]]</noinclude>
+<noinclude>[[Category:Platform]][[Category:JURI]]</noinclude>

@@ Line 1: / Line 1: @@
 This class is available in the following Joomla versions:-
 <splist showpath=notparent />
-<noinclude>[[Category:Platform]][[Category:JURI]]</noinclude>
+<noinclude>[[Category:Framework]][[Category:JURI]]</noinclude>

← Older revision		Revision as of 22:46, 3 July 2009
Line 16:		Line 16:

	The JURI class effectively provides a wrapper around the PHP [http://www.php.net/manual/en/function.parse-url.php parse_url] function.		The JURI class effectively provides a wrapper around the PHP [http://www.php.net/manual/en/function.parse-url.php parse_url] function.
		+
		+	===Availability===
		+	{{JVer\|1.5}} {{JVer\|1.6}}

	===Defined in===		===Defined in===

@@ Line 94: / Line 94: @@
 |-
 |[[JURI/buildQuery|buildQuery]]
-|Build query from an array.
+|Build the query part of a URI from an array of query items.
 |-
 |[[JURI/current|current]]
@@ Line 103: / Line 103: @@
 |-
 |[[JURI/getInstance|getInstance]]
-|Returns a reference to the global JURI object, only creating it if it doesn't already exist.  This is the URI that caused the current page to be rendered.
+|Returns a reference to the global JURI object, only creating it if it doesn't already exist.  The global URI object represents the URI that caused the current page to be rendered.
 |-
 |[[JURI/isInternal|isInternal]]
@@ Line 120: / Line 120: @@
 |Returns the full URI represented by the URI object in string format.
 |}
 ===Importing===
 <source lang="php">jimport( 'joomla.environment.uri' );</source>