kosmosafive/bitrix-localization

Kosmos: Bitrix Localization

1.0.0 2025-07-16 12:13 UTC

Requires

• php: >=8.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.82

MIT

• Siarhei Buinevich

• i18n
• translation
• localization
• bitrix
• loc

README

Расширение стандартного функционала локализации Bitrix.

Конфигурация

Конфигурацию рекомендуется указывать в файле /bitrix/.settings_extra.php.

• defaultLanguage — (опционально) язык по умолчанию.

return [
    'localization' => [
        'value' => [
            'defaultLanguage' => 'ru',
        ],
    ],
];

Использование

Kosmos\Bitrix\Localization\Loc

Класс расширяет функционал стандартного класса Bitrix\Main\Localization\Loc.

getMessage

public static function getMessage(
        string $code,
        ?array $replace = null,
        ?string $language = null,
        ?string $defaultLanguage = null
    ): ?string

• defaultLanguage — (опционально) язык по умолчанию. если не найдена языковая фраза на запрашиваемом языке, будет выполнен поиск на языке по умолчанию. если параметр не передан, будет использоваться значение из конфигурации.