PHP Класс yii\helpers\BaseUrl

Do not use BaseUrl. Use [[Url]] instead.
С версии: 2.0
Автор: Alexander Makarov ([email protected])
Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$urlManager URL manager to use for creating URLs

Открытые методы

Метод Описание
base ( boolean | string $scheme = false ) : string Returns the base URL of the current request.
canonical ( ) : string Returns the canonical URL of the currently requested page.
current ( array $params = [], boolean | string $scheme = false ) : string Creates a URL by using the current route and the GET parameters.
ensureScheme ( string $url, string $scheme ) : string Normalize URL by ensuring that it use specified scheme.
home ( boolean | string $scheme = false ) : string Returns the home URL.
isRelative ( string $url ) : boolean Returns a value indicating whether a URL is relative.
previous ( string $name = null ) : string | null Returns the URL previously [[remember()|remembered]].
remember ( string | array $url = '', string $name = null ) Remembers the specified URL so that it can be later fetched back by BaseUrl::previous.
to ( array | string $url = '', boolean | string $scheme = false ) : string Creates a URL based on the given parameters.
toRoute ( string | array $route, boolean | string $scheme = false ) : string Creates a URL for the given route.

Защищенные методы

Метод Описание
getUrlManager ( ) : UrlManager
normalizeRoute ( string $route ) : string Normalizes route and makes it suitable for UrlManager. Absolute routes are staying as is while relative routes are converted to absolute ones.

Описание методов

base() публичный статический Метод

Returns the base URL of the current request.
public static base ( boolean | string $scheme = false ) : string
$scheme boolean | string the URI scheme to use in the returned base URL: - `false` (default): returning the base URL without host info. - `true`: returning an absolute base URL whose scheme is the same as that in [[\yii\web\UrlManager::$hostInfo]]. - string: returning an absolute base URL with the specified scheme (either `http`, `https` or empty string for protocol-relative URL).
Результат string

canonical() публичный статический Метод

The canonical URL is constructed using the current controller's [[\yii\web\Controller::route]] and [[\yii\web\Controller::actionParams]]. You may use the following code in the layout view to add a link tag about canonical URL: php $this->registerLinkTag(['rel' => 'canonical', 'href' => Url::canonical()]);
public static canonical ( ) : string
Результат string the canonical URL of the currently requested page

current() публичный статический Метод

You may modify or remove some of the GET parameters, or add additional query parameters through the $params parameter. In particular, if you specify a parameter to be null, then this parameter will be removed from the existing GET parameters; all other parameters specified in $params will be merged with the existing GET parameters. For example, php assume $_GET = ['id' => 123, 'src' => 'google'], current route is "post/view" /index.php?r=post%2Fview&id=123&src=google echo Url::current(); /index.php?r=post%2Fview&id=123 echo Url::current(['src' => null]); /index.php?r=post%2Fview&id=100&src=google echo Url::current(['id' => 100]); Note that if you're replacing array parameters with [] at the end you should specify $params as nested arrays. For a PostSearchForm model where parameter names are PostSearchForm[id] and PostSearchForm[src] the syntax would be the following: php index.php?r=post%2Findex&PostSearchForm%5Bid%5D=100&PostSearchForm%5Bsrc%5D=google echo Url::current([ $postSearch->formName() => ['id' => 100, 'src' => 'google'], ]);
С версии: 2.0.3
public static current ( array $params = [], boolean | string $scheme = false ) : string
$params array an associative array of parameters that will be merged with the current GET parameters. If a parameter value is null, the corresponding GET parameter will be removed.
$scheme boolean | string the URI scheme to use in the generated URL: - `false` (default): generating a relative URL. - `true`: returning an absolute base URL whose scheme is the same as that in [[\yii\web\UrlManager::$hostInfo]]. - string: generating an absolute URL with the specified scheme (either `http`, `https` or empty string for protocol-relative URL).
Результат string the generated URL

ensureScheme() публичный статический Метод

If URL is relative or scheme is not string, normalization is skipped.
С версии: 2.0.11
public static ensureScheme ( string $url, string $scheme ) : string
$url string the URL to process
$scheme string the URI scheme used in URL (e.g. `http` or `https`). Use empty string to create protocol-relative URL (e.g. `//example.com/path`)
Результат string the processed URL

getUrlManager() защищенный статический Метод

С версии: 2.0.8
protected static getUrlManager ( ) : UrlManager
Результат yii\web\UrlManager URL manager used to create URLs

home() публичный статический Метод

Returns the home URL.
public static home ( boolean | string $scheme = false ) : string
$scheme boolean | string the URI scheme to use for the returned URL: - `false` (default): returning a relative URL. - `true`: returning an absolute base URL whose scheme is the same as that in [[\yii\web\UrlManager::$hostInfo]]. - string: returning an absolute URL with the specified scheme (either `http`, `https` or empty string for protocol-relative URL).
Результат string home URL

isRelative() публичный статический Метод

A relative URL does not have host info part.
public static isRelative ( string $url ) : boolean
$url string the URL to be checked
Результат boolean whether the URL is relative

normalizeRoute() защищенный статический Метод

A relative route is a route without a leading slash, such as "view", "post/view". - If the route is an empty string, the current [[\yii\web\Controller::route|route]] will be used; - If the route contains no slashes at all, it is considered to be an action ID of the current controller and will be prepended with [[\yii\web\Controller::uniqueId]]; - If the route has no leading slash, it is considered to be a route relative to the current module and will be prepended with the module's uniqueId. Starting from version 2.0.2, a route can also be specified as an alias. In this case, the alias will be converted into the actual route first before conducting the above transformation steps.
protected static normalizeRoute ( string $route ) : string
$route string the route. This can be either an absolute route or a relative route.
Результат string normalized route suitable for UrlManager

previous() публичный статический Метод

Returns the URL previously [[remember()|remembered]].
См. также: remember()
public static previous ( string $name = null ) : string | null
$name string the named associated with the URL that was remembered previously. If not set, it will use [[\yii\web\User::returnUrlParam]].
Результат string | null the URL previously remembered. Null is returned if no URL was remembered with the given name.

remember() публичный статический Метод

Remembers the specified URL so that it can be later fetched back by BaseUrl::previous.
См. также: previous()
public static remember ( string | array $url = '', string $name = null )
$url string | array the URL to remember. Please refer to [[to()]] for acceptable formats. If this parameter is not specified, the currently requested URL will be used.
$name string the name associated with the URL to be remembered. This can be used later by [[previous()]]. If not set, it will use [[\yii\web\User::returnUrlParam]].

to() публичный статический Метод

This method is very similar to BaseUrl::toRoute. The only difference is that this method requires a route to be specified as an array only. If a string is given, it will be treated as a URL. In particular, if $url is - an array: BaseUrl::toRoute will be called to generate the URL. For example: ['site/index'], ['post/index', 'page' => 2]. Please refer to BaseUrl::toRoute for more details on how to specify a route. - a string with a leading @: it is treated as an alias, and the corresponding aliased string will be returned. - an empty string: the currently requested URL will be returned; - a normal string: it will be returned as is. When $scheme is specified (either a string or true), an absolute URL with host info (obtained from [[\yii\web\UrlManager::$hostInfo]]) will be returned. If $url is already an absolute URL, its scheme will be replaced with the specified one. Below are some examples of using this method: php /index.php?r=site%2Findex echo Url::to(['site/index']); /index.php?r=site%2Findex&src=ref1#name echo Url::to(['site/index', 'src' => 'ref1', '#' => 'name']); /index.php?r=post%2Findex assume the alias "@posts" is defined as "/post/index" echo Url::to(['@posts']); the currently requested URL echo Url::to(); /images/logo.gif echo Url::to('@web/images/logo.gif'); images/logo.gif echo Url::to('images/logo.gif'); http://www.example.com/images/logo.gif echo Url::to('@web/images/logo.gif', true); https://www.example.com/images/logo.gif echo Url::to('@web/images/logo.gif', 'https'); //www.example.com/images/logo.gif echo Url::to('@web/images/logo.gif', '');
public static to ( array | string $url = '', boolean | string $scheme = false ) : string
$url array | string the parameter to be used to generate a valid URL
$scheme boolean | string the URI scheme to use in the generated URL: - `false` (default): generating a relative URL. - `true`: returning an absolute base URL whose scheme is the same as that in [[\yii\web\UrlManager::$hostInfo]]. - string: generating an absolute URL with the specified scheme (either `http`, `https` or empty string for protocol-relative URL).
Результат string the generated URL

toRoute() публичный статический Метод

This method will use UrlManager to create a URL. You may specify the route as a string, e.g., site/index. You may also use an array if you want to specify additional query parameters for the URL being created. The array format must be: php generates: /index.php?r=site/index¶m1=value1¶m2=value2 ['site/index', 'param1' => 'value1', 'param2' => 'value2'] If you want to create a URL with an anchor, you can use the array format with a # parameter. For example, php generates: /index.php?r=site/index¶m1=value1#name ['site/index', 'param1' => 'value1', '#' => 'name'] A route may be either absolute or relative. An absolute route has a leading slash (e.g. /site/index), while a relative route has none (e.g. site/index or index). A relative route will be converted into an absolute one by the following rules: - If the route is an empty string, the current [[\yii\web\Controller::route|route]] will be used; - If the route contains no slashes at all (e.g. index), it is considered to be an action ID of the current controller and will be prepended with [[\yii\web\Controller::uniqueId]]; - If the route has no leading slash (e.g. site/index), it is considered to be a route relative to the current module and will be prepended with the module's [[\yii\base\Module::uniqueId|uniqueId]]. Starting from version 2.0.2, a route can also be specified as an alias. In this case, the alias will be converted into the actual route first before conducting the above transformation steps. Below are some examples of using this method: php /index.php?r=site%2Findex echo Url::toRoute('site/index'); /index.php?r=site%2Findex&src=ref1#name echo Url::toRoute(['site/index', 'src' => 'ref1', '#' => 'name']); http://www.example.com/index.php?r=site%2Findex echo Url::toRoute('site/index', true); https://www.example.com/index.php?r=site%2Findex echo Url::toRoute('site/index', 'https'); /index.php?r=post%2Findex assume the alias "@posts" is defined as "post/index" echo Url::toRoute('@posts');
public static toRoute ( string | array $route, boolean | string $scheme = false ) : string
$route string | array use a string to represent a route (e.g. `index`, `site/index`), or an array to represent a route with query parameters (e.g. `['site/index', 'param1' => 'value1']`).
$scheme boolean | string the URI scheme to use in the generated URL: - `false` (default): generating a relative URL. - `true`: returning an absolute base URL whose scheme is the same as that in [[\yii\web\UrlManager::$hostInfo]]. - string: generating an absolute URL with the specified scheme (either `http`, `https` or empty string for protocol-relative URL).
Результат string the generated URL

Описание свойств

$urlManager публичное статическое свойство

URL manager to use for creating URLs
С версии: 2.0.8
public static $urlManager