Задать язык Context::setLanguage
Модуль: main — подключать отдельно не нужно
Метод Context::setLanguage задает язык контекста и возвращает тот же контекст. Ядро вызывает метод в начале запроса, когда определяет язык.
Сигнатура метода в классе Bitrix\Main\Context:
public function setLanguage($language)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| language* | string или Bitrix\Main\Localization\EO_Language |
Задает идентификатор языка, например en, или объект языка. Для строки метод загружает поля языка из базы данных |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает текущий контекст.
Особенности
- Метод не проверяет, что язык существует. Для несуществующего идентификатора getLanguage возвращает этот идентификатор, а поля объекта языка равны
null. - Метод меняет только контекст и не меняет константу
LANGUAGE_IDи региональные настройки контекста. - Класс
Locзапоминает язык сообщений при первом обращении. Чтобы сменить язык сообщений после этого, вызовитеLoc::setCurrentLang.
Примеры
Пример. Код временно переключает язык контекста на английский и восстанавливает прежний язык, если он был задан:
<?php
use Bitrix\Main\Context;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$context = Context::getCurrent();
$previousLanguage = $context->getLanguageObject();
try
{
$context->setLanguage('en');
echo $context->getLanguage() . ' ' . $context->getLanguageObject()->getName();
}
finally
{
if ($previousLanguage !== null)
{
$context->setLanguage($previousLanguage);
}
}
Если на сайте есть английский язык, код выведет en English.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая