robotdance/php-i18n

Simple I18N library for PHP

PHP-I18n

, _(*1)

PHP-I18n is a simple I18N and L10n library., _(*2)

Setup

PHP-I18n uses Composer as dependency management tool., _(*3)

$ composer install, _(*4)

Use

Create a folder called config/locales at your app/module, and put your locale YAML files there. (an example of valid YAML file can found in the source). Then call I18n::t, in one of the ways below., _(*5)

Simple key/value lookup

$translated = I18n::t('example_message');

Locale override

$translated = I18n::t('example_message', [], 'pt_BR');

Injecting arguments

$translated = I18n::t('hello_message', ['user' => 'Bob']); // 'Hello Bob'

Note about formatting currently the library does not apply formatting to arguments., _(*6)

Localisation

Create a section 'l10n' on your locale file and follow the source standards., _(*7)

$value = I18n::l(true);    // 'verdadeiro'
$value = I18n::l(123.45); // '123,45'

Running tests

$ ./bin/phpunit, _(*8)

Contribute

Fork, write tests, code, submit pull request. Coverage must remains at 100%., _(*9)

References

PHP the right way Fixing PHP errors automatically PHP SPL Exceptions What exception subclasses are buit in, _(*10)