Получить копию с другой схемой 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/.

Смотрите также