Задать хост Uri::setHost

Модуль: main — подключать отдельно не нужно

Доступно с версии: 14.0.15

Метод Uri::setHost задает хост адреса. Метод меняет сам объект. Чтобы получить копию с другим хостом, используйте withHost.

Сигнатура метода в классе Bitrix\Main\Web\Uri:

public function setHost($host)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
host* string Задает хост без схемы и порта. Метод приводит его к нижнему регистру

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

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

Метод возвращает тот же объект Uri.

Особенности

Метод не меняет схему. Если задать хост относительному адресу, getUri вернет адрес с // в начале. Задайте схему методом withScheme или используйте toAbsolute.

Примеры

Пример. Код переносит ссылку на другой хост:

<?php
use Bitrix\Main\Web\Uri;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$uri = new Uri('https://example.com/units/?page=2');
$uri->setHost('Shop.Example.COM');

echo $uri->getUri();

Код выведет https://shop.example.com/units/?page=2.

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

Предыдущая
Следующая