https://github.com/ddrv/php-translator
PHP library for localization application
https://github.com/ddrv/php-translator
i18n internationalization l10n localization php php-library translation
Last synced: 29 days ago
JSON representation
PHP library for localization application
- Host: GitHub
- URL: https://github.com/ddrv/php-translator
- Owner: ddrv
- License: mit
- Created: 2020-05-02T14:47:21.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-07-04T12:05:18.000Z (almost 6 years ago)
- Last Synced: 2025-01-10T08:58:40.621Z (over 1 year ago)
- Topics: i18n, internationalization, l10n, localization, php, php-library, translation
- Language: PHP
- Homepage: https://packagist.org/packages/ddrv/translator
- Size: 17.6 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# ddrv/translator
[](https://packagist.org/packages/ddrv/translator)
[](https://packagist.org/packages/ddrv/translator/stats)
[](https://github.com/ddrv/php-translator/blob/master/LICENSE)
[](https://php.net)
PHP library for localization application.
# Install
1. Run in terminal:
```text
composer require ddrv/translator:^2
```
1. Include autoload file
```php
require_once 'vendor/autoload.php';
```
# Usage
1. Prepare translations
```php
'It is test!',
'hello' => 'Hello, %name%',
'count' => '%count% element|%count% elements|{0}no elements',
'interval' => '[-Inf,0[negative|[0,Inf]positive',
'multi' => [
'level' => [
'key' => 'It is key in multilevel array.',
],
],
];
```
```php
'Это тест!',
'hello' => 'Привет, %name%',
'count' => '%count% элемент|%count% элемента|%count% элементов|{0}элементов нет',
'interval' => '[-Inf,0[отрицательное|[0,Inf]положительное',
'multi' => [
'level' => [
'key' => 'Это ключ в многоуровневом массиве.',
],
],
];
```
1. Init library
```php
trans('default:test'); // It is test!
$translator->trans('default:multi.level.key'); // It is key in multilevel array.
$translator->trans('default:test', [], 'ru_RU'); // Это тест!
$translator->setLocale('ru_RU');
$translator->trans('default:test'); // Это тест!
$translator->trans('default:multi.level.key'); // Это ключ в многоуровневом массиве.
```
1. Parameters
```php
trans('default:hello', ['name' => 'Ivan']); // Hello, Ivan!
$translator->trans('default:hello', ['name' => 'John']); // Hello, John!
```
1. Pluralization
```php
trans('default:count', ['count' => 1]); // 1 element!
$translator->trans('default:count', ['count' => 2]); // 2 elements!
$translator->trans('default:interval', ['count' => -2]); // negative
$translator->trans('default:interval', ['count' => 2]); // positive
```
You can develop your loader that implements the `\Ddrv\Translator\Contract\DomainLoader` interface.
You can use multiple loaders at once
```php
addLoader($loader2);
$loader->addLoader($loader3);
$translations = new TranslationProvider($loader);
$translator = new Translator('en_US', $translations);
```
You may wrap your loader to `\Ddrv\Translator\Loader\CachedLoader`
```php