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)
Получить количество секунд до заданной даты.
protected int availableAt(DateTimeInterface|DateInterval|int $delay = 0)
Получить отметку времени "доступно в" в формате Unix timestamp.
protected DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)
Если заданное значение представляет интервал, преобразует его в экземпляр DateTime.
protected int currentTime()
Получить текущее системное время в формате Unix timestamp.
protected string runTimeForHumans(float $startTime, float $endTime = null)
Вычисляет и форматирует общее время выполнения для отображения в читаемом для человека виде.
static void macro(string $name, object|callable $macro)
Зарегистрировать пользовательское макро.
static void mixin(object $mixin, bool $replace = true)
Смешать другой объект в класс.
static bool hasMacro(string $name)
Проверяет, зарегистрирован ли макрос.
static void flushMacros()
Очистить существующие макросы.
static mixed __callStatic(string $method, array $parameters)
Динамически обрабатывать вызовы класса.
mixed __call(string $method, array $parameters)
Динамически обрабатывать вызовы класса.
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)
Получить предыдущий путь для запроса.
protected 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.
protected string removeIndex(string $root)
Удалить файл index.php из пути.
string formatScheme(bool|null $secure = null)
Получить схему по умолчанию для обычного URL.
строка signedRoute(строка $name, смешанный $parameters = [], DateTimeInterface|DateInterval|int|null $expiration = null, bool $absolute = true)
Создать URL подписанной маршрута для именованного маршрута.
protected пусто ensureSignedRouteParametersAreNotReserved(смешанный $parameters)
Убедиться, что заданные параметры подписанного маршрута не зарезервированы.
строка temporarySignedRoute(строка $name, DateTimeInterface|DateInterval|int $expiration, массив $parameters = [], bool $absolute = true)
Создать URL временного подписанного маршрута для именованного маршрута.
логическое hasValidSignature(Запрос $request, bool $absolute = true, массив $ignoreQuery = [])
Определить, имеет ли данный запрос действительную подпись.
логическое hasValidRelativeSignature(Запрос $request, массив $ignoreQuery = [])
Определить, имеет ли данный запрос действительную подпись для относительного URL.
логическое hasCorrectSignature(Запрос $request, bool $absolute = true, массив $ignoreQuery = [])
Определить, соответствует ли подпись из данного запроса URL.
логическое signatureHasNotExpired(Запрос $request)
Определить, не истек ли отметка времени истечения срока действия из данного запроса.
строка route(строка $name, смешанный $parameters = [], bool $absolute = true)
Получить URL по именованному маршруту.
строка toRoute(Маршрут $route, смешанный $parameters, bool $absolute)
Получить URL для данного экземпляра маршрута.
строка action(строка|массив $action, смешанный $parameters = [], bool $absolute = true)
Получить URL к действию контроллера.
protected строка formatAction(строка|массив $action)
Отформатировать заданное действие контроллера.
массив formatParameters(смешанный|массив $parameters)
Отформатировать массив параметров URL.
protected массив extractQueryString(строка $path)
Извлечь строку запроса из данного пути.
строка formatRoot(строка $scheme, строка|null $root = null)
Получить базовый URL для запроса.
строка format(строка $root, строка $path, Маршрут|null $route = null)
Отформатировать заданные сегменты URL в единый URL.
bool isValidUrl(string $path)
Определить, является ли заданный путь допустимым URL.
protected 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)
Установить коллекцию маршрутов.
protected 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)
Установить корневое пространство имен контроллеров.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/11.x/Illuminate/Routing/UrlGenerator.html