Локализация

App\Lang\Loc загружает словари сообщений и позволяет получать строки по ключу.

Добавление файлов локализации

Используйте метод App\Lang\Loc::addFile($file, $needFullPath = false), чтобы зарегистрировать языковые файлы:

App\Lang\Loc::addFile(ROOT_FULL_PATH . '/lang/ru/main.php');
App\Lang\Loc::addFile('/lang/ru/blog.php', true);

Пример структуры файлов

lang/ru/main.php

return [
    'MAIN_TITLE' => 'Главная',
    'MAIN_DESCRIPTION' => 'Главная страница сервиса',
];

lang/ru/blog.php

return [
    'BLOG_TITLE' => 'Блог',
    'BLOG_DESCRIPTION' => 'Страница блога',
];

Инициализация файлов

Инициализация файлов происходит автоматически на старте загрузки приложения вызовом метода App\Lang\Loc::init(). Этот момент описан в разделе Начало: Жизненный цикл запроса.

Получение сообщений

Для получения строки используйте метод App\Lang\Loc::getMessage($key, $default = null).

echo App\Lang\Loc::getMessage('MAIN_TITLE');
echo PHP_EOL;
echo App\Lang\Loc::getMessage('MAIN_DESCRIPTION');
echo PHP_EOL;
echo App\Lang\Loc::getMessage('BLOG_TITLE');
echo PHP_EOL;
echo App\Lang\Loc::getMessage('BLOG_DESCRIPTION');
echo PHP_EOL;
echo App\Lang\Loc::getMessage('OTHER', 'Значение по умолчанию');