PHPackages                             rostenkowski/translate - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. rostenkowski/translate

ActiveLibrary[Localization & i18n](/categories/localization)

rostenkowski/translate
======================

v1.0.3(8y ago)42752[1 issues](https://github.com/rostenkowski/translate/issues)PHPPHP >=7.1

Since Oct 2Pushed 7y ago1 watchersCompare

[ Source](https://github.com/rostenkowski/translate)[ Packagist](https://packagist.org/packages/rostenkowski/translate)[ RSS](/packages/rostenkowski-translate/feed)WikiDiscussions master Synced yesterday

READMEChangelog (4)Dependencies (8)Versions (5)Used By (0)

Translate [![Build Status](https://camo.githubusercontent.com/eeb4c64b058c69547961c175a213467b4cbb63e0065fc15b8b91017c787461c4/68747470733a2f2f7472617669732d63692e6f72672f726f7374656e6b6f77736b692f7472616e736c6174652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/rostenkowski/translate) [![Coverage Status](https://camo.githubusercontent.com/dc95459d2388195c3ed7aeb50b7adec5602b3ab2a962a337a5b55232c18b9c40/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f726f7374656e6b6f77736b692f7472616e736c6174652f62616467652e737667)](https://coveralls.io/github/rostenkowski/translate)
==============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#translate--)

Minimalistic yet powerful high performance message localization PHP 7.1+ component not only for [Nette](https://nette.org) framework

```
composer require rostenkowski/translate
```

Translations
------------

[](#translations)

Translations are stored by default in \*.neon files in this format:

```
# 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

[](#usage-with-nette-framework)

Put your translations to `%appDir%/translations` directory as `cs_CZ.neon` etc.

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

# configuration
translate:
  default: cs_CZ
```

### Advanced options

[](#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`.

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

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

### Usage with plain PHP

[](#usage-with-plain-php)

```