Spec-Zone.ru › Laravel 11

UrlGenerator

класс UrlGenerator реализует UrlGenerator (Просмотреть исходный код)

Трейты

InteractsWithTime
Macroable

Свойства

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

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

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

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

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

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

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

Корневой URL для ресурсов.

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

Вынужденный корень URL.

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

Вынужденная схема для URL.

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

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

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

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

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

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

защищённая вызываемая функция $sessionResolver

Вызываемая функция для получения сессии.

защищённая вызываемая функция $keyResolver

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

защищённая вызываемая функция $missingNamedRouteResolver

Вызываемая функция для обработки отсутствующих именованных маршрутов.

защищённая Closure $formatHostUsing

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

защищённая Closure $formatPathUsing

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

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

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

Методы

int secondsUntil(DateTimeInterface|DateInterval|int $delay)

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

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

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

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

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

from InteractsWithTime
int currentTime()

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

from InteractsWithTime
string runTimeForHumans(float $startTime, float $endTime = null)

Учитывая начальное время, отформатировать общее время выполнения для удобного восприятия человеком.

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 void flushMacros()

Очистить существующие макросы.

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

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

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

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

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

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

string full()

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

string current()

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

string previous(mixed $fallback = false)

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

string previousPath(mixed $fallback = false)

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

string|null getPreviousUrlFromSession()

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

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

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

string query(string $path, array $query = [], 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, array $ignoreQuery = [])

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

bool hasValidRelativeSignature(Request $request, array $ignoreQuery = [])

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

bool hasCorrectSignature(Request $request, bool $absolute = true, array $ignoreQuery = [])

Определить, соответствует ли подпись из данного запроса 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|null $scheme)

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

void forceRootUrl(string|null $root)

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

$this formatHostUsing(Closure $callback)

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

$this formatPathUsing(Closure $callback)

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

Closure pathFormatter()

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

Request getRequest()

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

void setRequest(Request $request)

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

$this setRoutes(RouteCollectionInterface $routes)

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

Store|null getSession()

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

$this setSessionResolver(callable $sessionResolver)

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

$this setKeyResolver(callable $keyResolver)

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

UrlGenerator withKeyResolver(callable $keyResolver)

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

$this resolveMissingNamedRoutesUsing(callable $missingNamedRouteResolver)

Установить обработчик, который должен использоваться для попытки разрешения отсутствующих именованных маршрутов.

string getRootControllerNamespace()

Получить корневое пространство имён контроллеров.

$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

protected string runTimeForHumans(float $startTime, float $endTime = null)

Вычисляет и форматирует общее время выполнения для отображения в читаемом для человека виде.

Parameters

float $startTime
float $endTime

Return Value

string

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 void flushMacros()

Очистить существующие макросы.

Return Value

void

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(RouteCollectionInterface $routes, Request $request, string|null $assetRoot = null)

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

Parameters

RouteCollectionInterface $routes
Request $request
string|null $assetRoot

Return Value

void

string full()

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

Return Value

string

string current()

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

Return Value

string

string previous(mixed $fallback = false)

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

Parameters

mixed $fallback

Return Value

string

string previousPath(mixed $fallback = false)

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

Parameters

mixed $fallback

Return Value

string

protected string|null getPreviousUrlFromSession()

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

Return Value

string|null

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

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

Parameters

string $path
mixed $extra
bool|null $secure

Return Value

string

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

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

Parameters

string $path
array $query
mixed $extra
bool|null $secure

Return Value

string

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

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

Parameters

string $path
array $parameters

Return Value

string

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

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

Parameters

string $path
bool|null $secure

Return Value

string

string secureAsset(string $path)

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

Parameters

string $path

Return Value

string

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

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

Parameters

string $root
string $path
bool|null $secure

Return Value

string

protected string removeIndex(string $root)

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

Parameters

string $root

Return Value

string

string formatScheme(bool|null $secure = null)

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

Parameters

bool|null $secure

Return Value

string

строка signedRoute(строка $name, смешанный $parameters = [], DateTimeInterface|DateInterval|int|null $expiration = null, bool $absolute = true)

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

Параметры

строка $name
смешанный $parameters
DateTimeInterface|DateInterval|int|null $expiration
bool $absolute

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

строка

Исключения

InvalidArgumentException

protected пусто ensureSignedRouteParametersAreNotReserved(смешанный $parameters)

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

Параметры

смешанный $parameters

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

пусто

строка temporarySignedRoute(строка $name, DateTimeInterface|DateInterval|int $expiration, массив $parameters = [], bool $absolute = true)

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

Параметры

строка $name
DateTimeInterface|DateInterval|int $expiration
массив $parameters
bool $absolute

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

строка

логическое hasValidSignature(Запрос $request, bool $absolute = true, массив $ignoreQuery = [])

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

Параметры

Запрос $request
bool $absolute
массив $ignoreQuery

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

логическое

логическое hasValidRelativeSignature(Запрос $request, массив $ignoreQuery = [])

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

Параметры

Запрос $request
массив $ignoreQuery

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

логическое

логическое hasCorrectSignature(Запрос $request, bool $absolute = true, массив $ignoreQuery = [])

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

Параметры

Запрос $request
bool $absolute
массив $ignoreQuery

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

логическое

логическое signatureHasNotExpired(Запрос $request)

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

Параметры

Запрос $request

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

логическое

строка route(строка $name, смешанный $parameters = [], bool $absolute = true)

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

Параметры

строка $name
смешанный $parameters
bool $absolute

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

строка

Исключения

RouteNotFoundException

строка toRoute(Маршрут $route, смешанный $parameters, bool $absolute)

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

Параметры

Маршрут $route
смешанный $parameters
bool $absolute

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

строка

Исключения

UrlGenerationException

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

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

Параметры

строка|массив $action
смешанный $parameters
bool $absolute

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

строка

Исключения

InvalidArgumentException

protected строка formatAction(строка|массив $action)

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

Параметры

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

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

строка

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

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

Параметры

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

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

массив

protected массив extractQueryString(строка $path)

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

Параметры

строка $path

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

массив

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

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

Параметры

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

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

строка

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

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

Параметры

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

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

строка

bool isValidUrl(string $path)

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

Параметры

string $path

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

bool

protected RouteUrlGenerator routeUrl()

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

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

RouteUrlGenerator

void defaults(array $defaults)

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

Параметры

array $defaults

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

void

array getDefaultParameters()

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

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

array

void forceScheme(string|null $scheme)

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

Параметры

string|null $scheme

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

void

void forceRootUrl(string|null $root)

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

Параметры

string|null $root

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

void

$this formatHostUsing(Closure $callback)

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

Параметры

Closure $callback

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

$this

$this formatPathUsing(Closure $callback)

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

Параметры

Closure $callback

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

$this

Closure pathFormatter()

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

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

Closure

Request getRequest()

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

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

Request

void setRequest(Request $request)

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

Параметры

Request $request

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

void

$this setRoutes(RouteCollectionInterface $routes)

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

Параметры

RouteCollectionInterface $routes

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

$this

protected Store|null getSession()

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

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

Store|null

$this setSessionResolver(callable $sessionResolver)

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

Параметры

callable $sessionResolver

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

$this

$this setKeyResolver(callable $keyResolver)

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

Параметры

callable $keyResolver

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

$this

UrlGenerator withKeyResolver(callable $keyResolver)

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

Параметры

callable $keyResolver

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

UrlGenerator

$this resolveMissingNamedRoutesUsing(callable $missingNamedRouteResolver)

Установить обратный вызов, который должен использоваться для попытки решения отсутствующих именованных маршрутов.

Параметры

callable $missingNamedRouteResolver

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

$this

string getRootControllerNamespace()

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

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

string

$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/11.x/Illuminate/Routing/UrlGenerator.html

Spec-Zone.ru

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