Получить копию с другой схемой Uri::withScheme
Модуль: main — подключать отдельно не нужно
Метод Uri::withScheme возвращает копию адреса с другой схемой. Метод не меняет исходный объект. Метод входит в интерфейс PSR-7 UriInterface.
Сигнатура метода в классе Bitrix\Main\Web\Uri:
public function withScheme(string $scheme): UriInterface
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| scheme* | string |
Задает схему без :, например https |
Возвращаемое значение
Метод возвращает новый объект Uri.
Особенности
Метод не проверяет схему и не приводит ее к нижнему регистру, в отличие от конструктора. Передавайте схему в нижнем регистре. От нее зависят порт по умолчанию в getPort и вывод порта в getUri.
Примеры
Пример. Код получает HTTPS-вариант адреса:
<?php
use Bitrix\Main\Web\Uri;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$uri = new Uri('http://example.com/units/');
$secure = $uri->withScheme('https');
echo $uri->getUri() . ' ' . $secure->getUri();
Код выведет http://example.com/units/ https://example.com/units/.
Смотрите также
Была ли статья полезна?
Предыдущая