2017 © Pedro PelĂĄez
 

library translate

image

rostenkowski/translate

  • Thursday, December 14, 2017
  • by rostenkowski
  • Repository
  • 1 Watchers
  • 2 Stars
  • 201 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 5 Versions
  • 4 % Grown

The README.md

Translate Build Status Coverage Status

Minimalistic yet powerful high performance message localization PHP 7.1+ component not only for Nette framework, (*1)

composer require rostenkowski/translate

Translations

Translations are stored by default in *.neon files in this format:, (*2)

# simple message
Welcome!: VĂ­tejte!

# with placeholder
Hi %s!: Ahoj %s! 

# multiple forms
You have %s points.: 
  - MĂĄte %s bod.
  - MĂĄte %s body.
  - MĂĄte %s bodĆŻ.

Usage with Nette Framework

Put your translations to %appDir%/translations directory as cs_CZ.neon etc., (*3)

# register extension
extensions:
  translate: Rostenkowski\Translate\Extension

# configuration
translate:
  default: cs_CZ

Advanced options

You can use special plural form for the count of 0 (zero). In translation source file you can define this form under special index -1., (*4)

"%s problems detected":
  -1: "No problem detected"
  - "%s problem detected" 
  - "%s problems detected" 

```php $translator->useSpecialZeroForm = true; $translator->translate('%s problems detected', 0); // "No problem detected" instead of "0 problems detected", (*5)


### Usage with plain PHP ```php <?php namespace App; require __DIR__ . '/vendor/autoload.php'; use Rostenkowski\Translate\Translator; use Rostenkowski\Translate\NeonDictionary\NeonDictionaryFactory; // both translations and cache are in the same directory $translator = new Translator(new NeonDictionaryFactory(__DIR__, __DIR__)); $translator->setLocale('cs_CZ'); $translator->translate('Welcome!');

Requirements

  • PHP 7.1+
  • nette/di
  • nette/neon
  • nette/safe-stream
  • nette/utils
  • nette/tester

Contributing

# run tests
vendor/bin/tester -c tests/php.ini tests/

# code coverage report (requires xdebug)
vendor/bin/tester -c tests/php-coverage.ini --coverage-src src/ --coverage ~/report.html tests/  

# remove test artifacts
rm -rf tests/temp/cache/

The Versions