slexx/lang

Internalization library

v0.1 2017-12-28 19:20 UTC

Requires

• slexx/config: ^1.0
• slexx/pattern: ^1.2
• slexx/request: ^1.1

Requires (Dev)

• phpunit/phpunit: 6

MIT

• Aleksei Shchepkin

• i18n
• translation
• localization
• internationalization
• plural
• pluralization

README

Класс для управления локализацией, не привязан к файловой системе, может работать с любой структурой файлов и папок. Умеет работать с json, yaml, ini и php файлами.

// Устанавливаем файлы с переводами
Lang::setFile('ru', 'messages', __DIR__ . '/locales/ru/messages.json');
Lang::setFile('en', 'messages', __DIR__ . '/locales/en/messages.yaml');

// Устанавливаем локализацию
Lang::setLocale(Lang::searchLocale('ru'));

// Добываем переводы в нужных местах
Lang::translate('messages:key');

Установка

Установка через composer:

$ composer require slexx/lang

Документация

Lang::setFile($locale, $namespace, $path)

Устанавливает файл локализации

Аргументы:

Исключения:

Возвращает: void

Lang::hasFile($locale, $namespace)

Проверка существования файла локализации

Аргументы:

Возвращает: bool

Lang::getFile($locale, $namespace)

Получение пути к файлу локализации

Аргументы:

Возвращает: string, null - Путь к файлу или null в случае его отсуцтвия

Lang::removeFile($locale, $namespace)

Удаление файла локализации

Аргументы:

Возвращает: void

Lang::getLocales()

Получение списка всех доступных локализаций

Возвращает: string[]

Lang::props($string, $props)

Замена переменных в строке

Возвращает: string

Пример:

echo Lang::props('Hello, :name!', ['name' => 'World']);
// Hello, World!

Lang::parseAcceptLanguage()

Парсинг HTTP заголовка Accept-Language

Возвращает: array

Пример:

var_dump(Lang::parseAcceptLanguage());
// [
//     ['code' => 'ru', 'region' => 'RU', 'quality' => 1],
//     ['code' => 'ru', 'region' => null, 'quality' => 0.8],
//     ['code' => 'en', 'region' => 'US', 'quality' => 0.6],
//     ['code' => 'en', 'region' => null, 'quality' => 0.4],
//     ...
// ]

Lang::hasLocale($locale)

Проверка доступности локализации

Аргументы:

Возвращает: bool

Lang::setLocale($locale)

Установка локализации

Аргументы:

Исключения:

Возвращает: void

Lang::getLocale()

Получение локализации

Возвращает: string

Lang::searchLocale([$default])

Ищет наиболее подходящюю локализацию по заголовку Accept-Language. Перед использованием метода следует указать файлы локализации с помощью метода setFile

Аргументы:

Возвращает: string - ISO код наиболее подходящей локализации

Lang::raw($path)

Получение сырого не обработанного перевода

Аргументы:

Исключения:

Возвращает: array, string, null

Lang::translate($path[, $props])

Получение перевода с заменой параметров

Аргументы:

Исключения:

Возвращает: string

Пример:

messages.php:

<?php
return [
    'hello' => 'Привет, :name!',
];

index.php:

Lang::setFile('ru', 'messages', __DIR__ . '/messages.php');
Lang::setLocale('ru');

echo Lang::translate('messages:hello', ['name' => 'Алексей']);
// Выведет: 'Привет, Алексей!'

Lang::setPluralFunction($locale, $function)

Установка функции плюрализации для языка

Возвращает: void

Пример:

Lang::setPluralFunction('ru', function($n) {
    return $n%10==1&&$n%100!=11?0:($n%10>=2&&$n%10<=4&&($n%100<10||$n%100>=20)?1:2);
});
Lang::setPluralFunction('en', function($n) {
    return $n>1?1:0;
});

Lang::removePluralFunction($locale)

Удаление функции плюрализации для языка

Возвращает: void

Lang::hasPluralFunction($locale)

Проверка существования функции плюрализации для языка

Возвращает: bool

Lang::getPluralFunction($locale)

Получение функции плюрализации для языка

Возвращает: callable, null

Lang::getPluralFunction($path, $counter[, $props])

Плюрализация перевода

Возвращает: string

Исключения:

Пример:

blog.php:

<?php
return [
    'comments' => [':count комментарий', ':count комментария', ':count коментариев'],
];

index.php:

Lang::setFile('ru', 'blog', __DIR__ . '/blog.php');
Lang::setLocale('ru');

Lang::plural('blog:comments', 1); // 1 комментарий
Lang::plural('blog:comments', 2); // 2 комментария
Lang::plural('blog:comments', 45); // 45 коментариев