Задать сайт Context::setSite
Модуль: main — подключать отдельно не нужно
Доступно с версии: 14.0.0
Метод Context::setSite задает сайт контекста и возвращает тот же контекст. Ядро вызывает метод в начале запроса, когда определяет сайт.
Сигнатура метода в классе Bitrix\Main\Context:
public function setSite($site)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| site* | string или Bitrix\Main\EO_Site |
Задает идентификатор сайта, например s1, или объект сайта. Для строки метод загружает поля сайта из базы данных |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает текущий контекст.
Особенности
- Метод не проверяет, что сайт существует. Для несуществующего идентификатора getSite возвращает этот идентификатор, а поля объекта сайта равны
null. - Метод меняет только контекст и не меняет константы
SITE_ID,SITE_DIRи региональные настройки контекста.
Примеры
Пример. Код временно переключает контекст на сайт s1 и восстанавливает прежний сайт, если он был задан:
<?php
use Bitrix\Main\Context;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$context = Context::getCurrent();
$previousSite = $context->getSiteObject();
try
{
$context->setSite('s1');
echo $context->getSite() . ' ' . $context->getSiteObject()->getDir();
}
finally
{
if ($previousSite !== null)
{
$context->setSite($previousSite);
}
}
Если сайт s1 находится в корне, код выведет s1 /.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая