jUrl
extends jUrlBase
in package
Object that contains url data, and which provides static method helpers.
Tags
Table of Contents
- JURL = 2
- JURLACTION = 3
- STRING = 0
- XMLSTRING = 1
- $params : mixed
- parameters.
- $pathInfo : string
- path info part of the url.
- $scriptName : string
- script name including its path.
- __construct() : mixed
- constructor.
- __toString() : mixed
- magic method for echo and others.
- appendToUrlString() : string
- Adds parameters to the given url.
- clearParam() : mixed
- Clear parameters.
- delParam() : mixed
- delete a parameter.
- escape() : string
- escape and simplier a string to be a part of an url path remove or replace not allowed characters etc.
- get() : mixed
- Gets the url corresponding to an action, in the given format.
- getCurrentUrl() : string
- returns the current Url.
- getFull() : string
- Gets the absolute url corresponding to an action, in the given format with the domainName in defaultConfig or current.
- getParam() : string
- get a parameter value.
- getPath() : string
- get the path part of the url (scriptName + pathinfo).
- getQuery() : string
- get the query part of the url.
- getRootUrl() : string
- get the root url for a given ressource type. Root URLs are stored in config file.
- getRootUrlRessourceValue() : string
- get the config value of an item in [rootUrls] section of config.
- isUrlFromApp() : bool
- tells if the given url is for the current application or if it matches given authorized domains.
- parse() : jUrlAction
- Parse a url.
- setParam() : mixed
- add or change the value of a parameter.
- toString() : string
- converts the url to a string.
- unescape() : string
- perform the opposit of escape.
Constants
JURL
public
mixed
JURL
= 2
JURLACTION
public
mixed
JURLACTION
= 3
STRING
public
mixed
STRING
= 0
XMLSTRING
public
mixed
XMLSTRING
= 1
Properties
$params
parameters.
public
mixed
$params
= array()
$pathInfo
path info part of the url.
public
string
$pathInfo
= ''
$scriptName
script name including its path.
public
string
$scriptName
Methods
__construct()
constructor.
public
__construct([string $scriptname = '' ][, array<string|int, mixed> $params = array() ][, string $pathInfo = '' ]) : mixed
Parameters
- $scriptname : string = ''
-
script name
- $params : array<string|int, mixed> = array()
-
parameters
- $pathInfo : string = ''
-
path info contents
Return values
mixed —__toString()
magic method for echo and others.
public
__toString() : mixed
..
Return values
mixed —appendToUrlString()
Adds parameters to the given url.
public
static appendToUrlString(string $url[, array<string|int, mixed> $params = array() ][, bool $forxml = false ]) : string
Parameters
- $url : string
-
an URL
- $params : array<string|int, mixed> = array()
-
some parameters to append to the url
- $forxml : bool = false
-
if true, escape some characters to include the url into an html/xml document
Return values
string —the url
clearParam()
Clear parameters.
public
clearParam() : mixed
Return values
mixed —delParam()
delete a parameter.
public
delParam(string $name) : mixed
Parameters
- $name : string
-
parameter name
Return values
mixed —escape()
escape and simplier a string to be a part of an url path remove or replace not allowed characters etc.
public
static escape(string $str[, bool $highlevel = false ]) : string
.
Parameters
- $str : string
-
the string to escape
- $highlevel : bool = false
-
false : just to a urlencode. true, replace some characters
Return values
string —escaped string
get()
Gets the url corresponding to an action, in the given format.
public
static get(string $actSel[, array<string|int, mixed> $params = array() ], int $what) : mixed
Parameters
- $actSel : string
-
action selector. You can use # instead of the module or the action name, to specify the current url.
- $params : array<string|int, mixed> = array()
-
associative array with the parameters
- $what : int
-
the format you want : one of the jUrl const, STRING XMLSTRING JURL JURLACTION
Return values
mixed —a value, depending of the $what parameter
getCurrentUrl()
returns the current Url.
public
static getCurrentUrl([bool $forxml = false ][, mixed $full = false ]) : string
The URL is the URL for the frontend HTTP server, if your app is behind a proxy.
Parameters
- $forxml : bool = false
-
if true, escape some characters to include the url into an html/xml document
- $full : mixed = false
Return values
string —the url
getFull()
Gets the absolute url corresponding to an action, in the given format with the domainName in defaultConfig or current.
public
static getFull(string $actSel[, array<string|int, mixed> $params = array() ], int $what[, string $domainName = null ]) : string
Parameters
- $actSel : string
-
action selector. You can use # instead of the module or the action name, to specify the current url.
- $params : array<string|int, mixed> = array()
-
associative array with the parameters
- $what : int
-
the format you want : only jUrl::STRING or jUrl::XMLSTRING
- $domainName : string = null
-
Customized domain name
Tags
Return values
string —the url string
getParam()
get a parameter value.
public
getParam(string $name[, string $defaultValue = null ]) : string
Parameters
- $name : string
-
parameter name
- $defaultValue : string = null
-
the default value returned if the parameter doesn't exists
Return values
string —the value
getPath()
get the path part of the url (scriptName + pathinfo).
public
getPath() : string
Tags
Return values
string —getQuery()
get the query part of the url.
public
getQuery([bool $forxml = false ]) : string
Parameters
- $forxml : bool = false
-
true: some characters will be escaped
Tags
Return values
string —getRootUrl()
get the root url for a given ressource type. Root URLs are stored in config file.
public
static getRootUrl(string $ressourceType) : string
Parameters
- $ressourceType : string
-
Name of the ressource
Return values
string —the root URL corresponding to this ressource, or basePath if unknown
getRootUrlRessourceValue()
get the config value of an item in [rootUrls] section of config.
public
static getRootUrlRessourceValue(string $ressourceType) : string
Parameters
- $ressourceType : string
-
Name of the ressource
Return values
string —the config value of this value, null if it does not exist
isUrlFromApp()
tells if the given url is for the current application or if it matches given authorized domains.
public
static isUrlFromApp(string $url[, array<string|int, string> $authorizedDomains = array() ]) : bool
Parameters
- $url : string
- $authorizedDomains : array<string|int, string> = array()
Return values
bool —parse()
Parse a url.
public
static parse(string $scriptNamePath, string $pathinfo, array<string|int, mixed> $params) : jUrlAction
Parameters
- $scriptNamePath : string
-
/path/index.php
- $pathinfo : string
-
the path info of the url
- $params : array<string|int, mixed>
-
url parameter ($_REQUEST)
Return values
jUrlAction —setParam()
add or change the value of a parameter.
public
setParam(string $name, string $value) : mixed
Parameters
- $name : string
-
parameter name
- $value : string
-
parameter value
Return values
mixed —toString()
converts the url to a string.
public
toString([bool $forxml = false ]) : string
Parameters
- $forxml : bool = false
-
true: some characters will be escaped
Return values
string —unescape()
perform the opposit of escape.
public
static unescape(string $str) : string
Parameters
- $str : string
-
the string to escape