Spec-Zone.ru › Laravel 6

UrlGenerator

класс UrlGenerator реализует UrlGenerator (View source)

Трейты

InteractsWithTime
Macroable

Свойства

статический защищённый массив $macros

Зарегистрированные строковые макросы.

из Macroable
защищённый RouteCollection $routes

Коллекция маршрутов.

защищённый Request $request

Экземпляр запроса.

защищённая строка $assetRoot

URL корня активов.

защищённая строка $forcedRoot

Принудительный корень URL.

защищённая строка $forceScheme

Принудительный протокол для URL.

защищённая строка|null $cachedRoot

Кэшированная копия корня URL для текущего запроса.

защищённая строка|null $cachedScheme

Кэшированная копия протокола URL для текущего запроса.

защищённая строка $rootNamespace

Корневой namespace, применяемый к действиям контроллеров.

защищённый вызов $sessionResolver

Вызов для получения сессии.

защищённый вызов $keyResolver

Вызов для получения ключа шифрования.

защищённый Closure $formatHostUsing

Обратный вызов для форматирования хостов.

защищённый Closure $formatPathUsing

Обратный вызов для форматирования путей.

защищённый RouteUrlGenerator|null $routeGenerator

Экземпляр генератора URL маршрутов.

Методы

int secondsUntil(DateTimeInterface|DateInterval|int $delay)

Получить количество секунд до заданной даты DateTime.

from InteractsWithTime
int availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Получить отметку времени UNIX в формате «доступно в».

from InteractsWithTime
DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

Если заданное значение является интервалом, преобразовать его в экземпляр DateTime.

from InteractsWithTime
int currentTime()

Получить текущее системное время в формате UNIX timestamp.

from InteractsWithTime
static void macro(string $name, object|callable $macro)

Зарегистрировать пользовательское макро.

from Macroable
static void mixin(object $mixin, bool $replace = true)

Смешать другой объект в класс.

from Macroable
static bool hasMacro(string $name)

Проверяет, зарегистрировано ли макро.

from Macroable
static mixed __callStatic(string $method, array $parameters)

Динамически обрабатывает вызовы класса.

from Macroable
mixed __call(string $method, array $parameters)

Динамически обрабатывает вызовы класса.

from Macroable
void __construct(RouteCollection $routes, Request $request, string|null $assetRoot = null)

Создать новый экземпляр генератора URL.

string full()

Получить полный URL для текущего запроса.

string current()

Получить текущий URL для запроса.

string previous(mixed $fallback = false)

Получить URL для предыдущего запроса.

string|null getPreviousUrlFromSession()

Получить предыдущий URL из сессии, если возможно.

string to(string $path, mixed $extra = [], bool|null $secure = null)

Сгенерировать абсолютный URL для заданного пути.

string secure(string $path, array $parameters = [])

Сгенерировать защищенный абсолютный URL для заданного пути.

string asset(string $path, bool|null $secure = null)

Сгенерировать URL для ресурса приложения.

string secureAsset(string $path)

Сгенерировать URL для защищенного ресурса.

string assetFrom(string $root, string $path, bool|null $secure = null)

Сгенерировать URL для ресурса из пользовательского домена, например, CDN.

string removeIndex(string $root)

Удалить файл index.php из пути.

string formatScheme(bool|null $secure = null)

Получить схему по умолчанию для сырого URL.

string signedRoute(string $name, mixed $parameters = [], DateTimeInterface|DateInterval|int|null $expiration = null, bool $absolute = true)

Создать URL подписанного маршрута для именованного маршрута.

void ensureSignedRouteParametersAreNotReserved(mixed $parameters)

Убедиться, что заданные параметры подписанного маршрута не зарезервированы.

string temporarySignedRoute(string $name, DateTimeInterface|DateInterval|int $expiration, array $parameters = [], bool $absolute = true)

Создать временный URL подписанного маршрута для именованного маршрута.

bool hasValidSignature(Request $request, bool $absolute = true)

Определить, имеет ли данный запрос действительную подпись.

bool hasCorrectSignature(Request $request, bool $absolute = true)

Определить, соответствует ли подпись из данного запроса URL.

bool signatureHasNotExpired(Request $request)

Определить, не истекло ли время действия подписи из данного запроса.

string route(string $name, mixed $parameters = [], bool $absolute = true)

Получить URL для именованного маршрута.

string toRoute(Route $route, mixed $parameters, bool $absolute)

Получить URL для данного экземпляра маршрута.

string action(string|array $action, mixed $parameters = [], bool $absolute = true)

Получить URL для действия контроллера.

string formatAction(string|array $action)

Отформатировать заданное действие контроллера.

array formatParameters(mixed|array $parameters)

Отформатировать массив параметров URL.

array extractQueryString(string $path)

Извлечь строку запроса из заданного пути.

string formatRoot(string $scheme, string|null $root = null)

Получить базовый URL для запроса.

string format(string $root, string $path, Route|null $route = null)

Отформатировать указанные сегменты URL в один URL.

bool isValidUrl(string $path)

Определить, является ли заданный путь действительным URL.

RouteUrlGenerator routeUrl()

Получить экземпляр генератора URL маршрута.

void defaults(array $defaults)

Установить значения по умолчанию для именованных параметров, используемых генератором URL.

array getDefaultParameters()

Получить значения по умолчанию для именованных параметров, используемых генератором URL.

void forceScheme(string $scheme)

Принудительно задать схему для URL-адресов.

void forceRootUrl(string $root)

Установить принудительно корневой URL.

$this formatHostUsing(Closure $callback)

Установить обратный вызов для форматирования хоста сгенерированных URL.

$this formatPathUsing(Closure $callback)

Установить обратный вызов для форматирования пути сгенерированных URL.

Closure pathFormatter()

Получить форматировщик пути, используемый генератором URL.

Request getRequest()

Получить экземпляр запроса.

void setRequest(Request $request)

Установить текущий экземпляр запроса.

$this setRoutes(RouteCollection $routes)

Установить коллекцию маршрутов.

Store|null getSession()

Получить реализацию сессии из разрешителя.

$this setSessionResolver(callable $sessionResolver)

Установить разрешитель сессии для генератора.

$this setKeyResolver(callable $keyResolver)

Установить разрешитель ключа шифрования.

$this setRootControllerNamespace(string $rootNamespace)

Установить корневое пространство имен контроллеров.

Подробности

protected int secondsUntil(DateTimeInterface|DateInterval|int $delay)

Получить количество секунд до указанной даты и времени.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

int

protected int availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Получить отметку времени "доступно в" в формате UNIX timestamp.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

int

protected DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

Если заданное значение является интервалом, преобразовать его в экземпляр DateTime.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

DateTimeInterface|int

protected int currentTime()

Получить текущее системное время в формате UNIX timestamp.

Return Value

int

static void macro(string $name, object|callable $macro)

Зарегистрировать пользовательское макро.

Parameters

string $name
object|callable $macro

Return Value

void

static void mixin(object $mixin, bool $replace = true)

Смешать другой объект в класс.

Parameters

object $mixin
bool $replace

Return Value

void

Exceptions

ReflectionException

static bool hasMacro(string $name)

Проверяет, зарегистрировано ли макро.

Parameters

string $name

Return Value

bool

static mixed __callStatic(string $method, array $parameters)

Динамически обрабатывает вызовы класса.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

mixed __call(string $method, array $parameters)

Динамически обрабатывает вызовы класса.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

void __construct(RouteCollection $routes, Request $request, string|null $assetRoot = null)

Создать новый экземпляр генератора URL.

Parameters

RouteCollection $routes
Request $request
string|null $assetRoot

Return Value

void

string full()

Получить полный URL текущего запроса.

Значение возвращаемого значения

string

string current()

Получить текущий URL запроса.

Значение возвращаемого значения

string

string previous(mixed $fallback = false)

Получить URL предыдущего запроса.

Параметры

mixed $fallback

Значение возвращаемого значения

string

protected string|null getPreviousUrlFromSession()

Получить предыдущий URL из сессии, если это возможно.

Значение возвращаемого значения

string|null

string to(string $path, mixed $extra = [], bool|null $secure = null)

Сгенерировать абсолютный URL до заданного пути.

Параметры

string $path
mixed $extra
bool|null $secure

Значение возвращаемого значения

string

string secure(string $path, array $parameters = [])

Сгенерировать защищённый абсолютный URL до заданного пути.

Параметры

string $path
array $parameters

Значение возвращаемого значения

string

string asset(string $path, bool|null $secure = null)

Сгенерировать URL к активу приложения.

Параметры

string $path
bool|null $secure

Значение возвращаемого значения

string

string secureAsset(string $path)

Сгенерировать URL к защищённому активу.

Параметры

string $path

Значение возвращаемого значения

string

string assetFrom(string $root, string $path, bool|null $secure = null)

Сгенерировать URL к активу из пользовательского домена, такого как CDN и т.п.

Параметры

string $root
string $path
bool|null $secure

Значение возвращаемого значения

string

protected string removeIndex(string $root)

Удалить файл index.php из пути.

Параметры

string $root

Значение возвращаемого значения

string

string formatScheme(bool|null $secure = null)

Получить стандартную схему для необработанного URL.

Параметры

bool|null $secure

Значение возвращаемого значения

string

string signedRoute(string $name, mixed $parameters = [], DateTimeInterface|DateInterval|int|null $expiration = null, bool $absolute = true)

Создать URL подписанной маршрутизации для именованного маршрута.

Параметры

string $name
mixed $parameters
DateTimeInterface|DateInterval|int|null $expiration
bool $absolute

Значение возвращаемого значения

string

Исключения

InvalidArgumentException

protected void ensureSignedRouteParametersAreNotReserved(mixed $parameters)

Убедиться, что заданные параметры подписанного маршрута не зарезервированы.

Параметры

mixed $parameters

Значение возвращаемого значения

void

string temporarySignedRoute(string $name, DateTimeInterface|DateInterval|int $expiration, array $parameters = [], bool $absolute = true)

Создать временный URL подписанного маршрута для именованного маршрута.

Параметры

string $name
DateTimeInterface|DateInterval|int $expiration
array $parameters
bool $absolute

Значение возвращаемого значения

string

bool hasValidSignature(Request $request, bool $absolute = true)

Определить, имеет ли данный запрос действительную подпись.

Параметры

Request $request
bool $absolute

Значение возвращаемого значения

bool

bool hasCorrectSignature(Request $request, bool $absolute = true)

Определить, соответствует ли подпись из данного запроса URL.

Параметры

Request $request
bool $absolute

Значение возвращаемого значения

bool

bool signatureHasNotExpired(Request $request)

Определить, не является ли отметка о сроке действия из данного запроса из прошлого.

Параметры

Request $request

Значение возвращаемого значения

bool

string route(string $name, mixed $parameters = [], bool $absolute = true)

Получить URL по именованному маршруту.

Параметры

string $name
mixed $parameters
bool $absolute

Значение возвращаемого значения

string

Исключения

RouteNotFoundException

строка toRoute(Маршрут $route, смешанный тип $parameters, булево $absolute)

Получить URL для данного экземпляра маршрута.

Параметры

Маршрут $route
смешанный тип $parameters
булево $absolute

Возвращаемое значение

строка

Исключения

UrlGenerationException

строка action(строка|массив $action, смешанный тип $parameters = [], булево $absolute = true)

Получить URL для действия контроллера.

Параметры

строка|массив $action
смешанный тип $parameters
булево $absolute

Возвращаемое значение

строка

Исключения

InvalidArgumentException

защищённый строка formatAction(строка|массив $action)

Форматировать заданное действие контроллера.

Параметры

строка|массив $action

Возвращаемое значение

строка

массив formatParameters(смешанный тип|массив $parameters)

Форматировать массив параметров URL.

Параметры

смешанный тип|массив $parameters

Возвращаемое значение

массив

защищённый массив extractQueryString(строка $path)

Извлечь строку запроса из заданного пути.

Параметры

строка $path

Возвращаемое значение

массив

строка formatRoot(строка $scheme, строка|null $root = null)

Получить базовый URL для запроса.

Параметры

строка $scheme
строка|null $root

Возвращаемое значение

строка

строка format(строка $root, строка $path, Маршрут|null $route = null)

Форматировать заданные сегменты URL в один URL.

Параметры

строка $root
строка $path
Маршрут|null $route

Возвращаемое значение

строка

булево isValidUrl(строка $path)

Определить, является ли заданный путь допустимым URL.

Параметры

строка $path

Возвращаемое значение

булево

защищённый RouteUrlGenerator routeUrl()

Получить экземпляр генератора URL маршрута.

Возвращаемое значение

RouteUrlGenerator

пустое значение defaults(массив $defaults)

Установить значения по умолчанию для именованных параметров, используемых генератором URL.

Параметры

массив $defaults

Возвращаемое значение

пустое значение

массив getDefaultParameters()

Получить значения по умолчанию для именованных параметров, используемых генератором URL.

Возвращаемое значение

массив

пустое значение forceScheme(строка $scheme)

Принудительно установить схему для URL.

Параметры

строка $scheme

Возвращаемое значение

пустое значение

пустое значение forceRootUrl(строка $root)

Установить принудительный корневой URL.

Параметры

строка $root

Возвращаемое значение

пустое значение

$this formatHostUsing(Closure $callback)

Установить обратный вызов для форматирования хоста сгенерированных URL.

Параметры

Closure $callback

Возвращаемое значение

$this

$this formatPathUsing(Closure $callback)

Установить обратный вызов для форматирования пути сгенерированных URL.

Параметры

Closure $callback

Возвращаемое значение

$this

Closure pathFormatter()

Получить форматировщик пути, используемый генератором URL.

Возвращаемое значение

Closure

Запрос getRequest()

Получить экземпляр запроса.

Возвращаемое значение

Запрос

пустое значение setRequest(Запрос $request)

Установить текущий экземпляр запроса.

Параметры

Запрос $request

Возвращаемое значение

пустое значение

$this setRoutes(RouteCollection $routes)

Установить коллекцию маршрутов.

Параметры

RouteCollection $routes

Возвращаемое значение

$this

защищённый Хранилище|null getSession()

Получить реализацию сеанса из решателя.

Возвращаемое значение

Хранилище|null
END_OF_DOCUMENT_MARKER

$this setSessionResolver(callable $sessionResolver)

Установите решатель сессий для генератора.

Параметры

callable $sessionResolver

Возвращаемое значение

$this

$this setKeyResolver(callable $keyResolver)

Установите решатель ключа шифрования.

Параметры

callable $keyResolver

Возвращаемое значение

$this

$this setRootControllerNamespace(string $rootNamespace)

Установите пространство имён корневого контроллера.

Параметры

string $rootNamespace

Возвращаемое значение

$this

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/6.x/Illuminate/Routing/UrlGenerator.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API