Spec-Zone.ru › Laravel 9

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

Вызываемый объект для разрешения ключа шифрования.

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

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

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

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

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

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

Методы

int secondsUntil(DateTimeInterface|DateInterval|int $delay)

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

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

Получить отметку времени UNIX "доступно в" (available at).

из InteractsWithTime
DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

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

из InteractsWithTime
int currentTime()

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

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

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

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

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

из Macroable
static bool hasMacro(string $name)

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

из Macroable
static void flushMacros()

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

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

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

из Macroable
mixed __call(string $method, array $parameters)

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

из 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 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 с другим решателем ключа шифрования.

string getRootControllerNamespace()

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

$this setRootControllerNamespace(string $rootNamespace)

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

Подробности

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

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

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

int

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

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

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.

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

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

Return Value

void

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

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

Параметры

string $method
array $parameters

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

mixed

Исключения

BadMethodCallException

mixed __call(string $method, array $parameters)

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

Параметры

string $method
array $parameters

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

mixed

Исключения

BadMethodCallException

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

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

Параметры

RouteCollectionInterface $routes
Request $request
string|null $assetRoot

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

void

string full()

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

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

string

string current()

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

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

string

string previous(mixed $fallback = false)

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

Параметры

mixed $fallback

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

string

string previousPath(mixed $fallback = false)

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

Параметры

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
END_OF_DOCUMENT_MARKER

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

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

Parameters

Request $request
bool $absolute
array $ignoreQuery

Return Value

bool

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

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

Parameters

Request $request
array $ignoreQuery

Return Value

bool

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

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

Parameters

Request $request
bool $absolute
array $ignoreQuery

Return Value

bool

bool signatureHasNotExpired(Request $request)

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

Parameters

Request $request

Return Value

bool

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

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

Parameters

string $name
mixed $parameters
bool $absolute

Return Value

string

Exceptions

RouteNotFoundException

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

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

Parameters

Route $route
mixed $parameters
bool $absolute

Return Value

string

Exceptions

UrlGenerationException

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

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

Parameters

string|array $action
mixed $parameters
bool $absolute

Return Value

string

Exceptions

InvalidArgumentException

protected string formatAction(string|array $action)

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

Parameters

string|array $action

Return Value

string

array formatParameters(mixed|array $parameters)

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

Parameters

mixed|array $parameters

Return Value

array

protected array extractQueryString(string $path)

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

Parameters

string $path

Return Value

array

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

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

Parameters

string $scheme
string|null $root

Return Value

string

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

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

Parameters

string $root
string $path
Route|null $route

Return Value

string

bool isValidUrl(string $path)

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

Parameters

string $path

Return Value

bool

protected RouteUrlGenerator routeUrl()

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

Return Value

RouteUrlGenerator

void defaults(array $defaults)

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

Parameters

array $defaults

Return Value

void

array getDefaultParameters()

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

Return Value

array

void forceScheme(string|null $scheme)

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

Parameters

string|null $scheme

Return Value

void

void forceRootUrl(string|null $root)

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

Parameters

string|null $root

Return Value

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

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

Spec-Zone.ru

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