PHPackages ganti/i18next-php - 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. ganti/i18next-php ActiveLibrary[Localization & i18n](/categories/localization) ganti/i18next-php ================= PHP class for basic i18next functionality. 11641PHP Since Sep 22Pushed 6y agoCompare [ Source](https://github.com/ganti/i18next-php)[ Packagist](https://packagist.org/packages/ganti/i18next-php)[ RSS](/packages/ganti-i18next-php/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependenciesVersions (1)Used By (0) i18next-php =========== [](#i18next-php) PHP class for basic [i18next](https://www.i18next.com) functionality. Features -------- [](#features) - Support for [variables](http://i18next.com/pages/doc_features.html#interpolation) - Support for [context](http://i18next.com/pages/doc_features.html#context) - Support for [basic sprintf](http://i18next.com/pages/doc_features.html#sprintf) - Support for [basic plural forms](http://i18next.com/pages/doc_features.html#plurals) - Support for [multiline in JSON](http://i18next.com/pages/doc_features.html) ### Missing Features [](#missing-features) - Missing [interval plurals](http://i18next.com/pages/doc_features.html#plurals) - Formatting [date, datetime, time, strings](https://www.i18next.com/translation-function/formatting) Usage ----- [](#usage) ### basic usage [](#basic-usage) ``` // init i18next instance i18next::init('en'); // get translation by key echo i18next::getTranslation('animal.cat'); ``` **Output**: cat ### substitution of variables [](#substitution-of-variables) ``` "common": { "name_age" : "{{name}} is {{age}} years old" } ``` ``` echo i18next::getTranslation('common.name_age', array('name' => "Elisa", "age" => 32)); ``` **Output**: ``` Elisa is 32 years old ``` ### plural forms [](#plural-forms) There are diffrent ways on how to store plural forms in json ``` "animal":{ "dog": "dog", "dog_plural": "dogs", "cat": "{{count}} cat", "cat_plural": "{{count}} cats", "elephant": "{{count}} elephant", "elephant_0": "no elephants", "elephant_2": "{{count}} elephants", "spiderWithCount" : "{{count}} spider", "spiderWithCount_plural" : "{{count}} spiders", "spiderWithCount_plural_0" : "no spiders" } ``` ``` // get translation by key with plural forms echo i18next::getTranslation('animal.cat', array('count' => 2)); echo i18next::getTranslation('animal.cat', 2); ``` **Output**: ``` 2 cats 2 cats ``` ``` echo i18next::getTranslation('animal.elephant', array('count' => 0)); echo i18next::getTranslation('animal.elephant', array('count' => 1)); echo i18next::getTranslation('animal.elephant', array('count' => 2)); echo i18next::getTranslation('animal.elephant', array('count' => 100)); ``` **Output**: ``` no elephants 1 elephant 2 elephants 100 elephants ``` ### Context [](#context) By providing a context you can differ translations. Eg. useful to provide gender specific translations. ``` "people":{ "friend" : "A friend", "friend_female" : "A girlfriend", "friend_female_plural" : "{{count}} girlfriends", "friend_male" : "A boyfriend", "friend_male_0" : "no boyfriend", "friend_male_plural" : "{{count}} boyfriends" } ``` ``` echo i18next::getTranslation('people.friend'); echo i18next::getTranslation('people.friend', array('context' => 'female')); echo i18next::getTranslation('people.friend', array('count' => 2, 'context' => 'female')); echo i18next::getTranslation('people.friend', array('count' => 0, 'context' => 'male')); echo i18next::getTranslation('people.friend', array('count' => 1, 'context' => 'male')); echo i18next::getTranslation('people.friend', array('count' => 33, 'context' => 'male')); ``` **Output**: ``` A friend A girlfirend 2 girlfriends no boyfriends A boyfriend 33 boyfriends ``` Methods ------- [](#methods) ### i18next::init( string $languageKey \[, string $path \] ); [](#i18nextinit-string-languagekey--string-path--) Loads translation files from given path. Looks for `translation.json` by default. ``` i18next::init('en', 'my/path/'); // loads my/path/translation.json ``` You can also use variables and split namespaces and languages to different files. ``` i18next::init('en', 'languages/__lng__/__ns__.json'); // loads languages/en/common.json, languages/fi/common.json, etc... ``` Method throws an exception if no files are found or the json can not be parsed. ### mixed i18next::getTranslation( string $key \[, array $variables \] ); [](#mixed-i18nextgettranslation-string-key--array-variables--) Returns translated string by key. ``` i18next::getTranslation('common.cat', array('count' => 2, 'lng' => 'fi')); ``` ### boolean i18next::existTranslation( string $key ); [](#boolean-i18nextexisttranslation-string-key-) Checks if translated string exists. ### void i18next::setLanguage( string $language \[, string $fallback \] ); [](#void-i18nextsetlanguage-string-language--string-fallback--) Changes language. ### array i18next::getMissingTranslations(); [](#array-i18nextgetmissingtranslations) Gets an array of missing translations. ``` array(1) { [0]=> array(2) { ["language"]=> string(2) "en" ["key"]=> string(14) "common.unknown" } } ``` Multilines in JSON-arrays ------------------------- [](#multilines-in-json-arrays) You can have html content written with multilines in JSON File ``` { "en": { "common": { "thedoglovers":["The Dog Lovers by Spike Milligan", "So they bought you", "And kept you in a", "Very good home"] } } } ``` Development =========== [](#development) Run Tests --------- [](#run-tests) `composer test` ### Health Score 22 — LowBetter than 22% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community12 Small or concentrated contributor base Maturity36 Early-stage or recently created project Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/944a6adcd9f8a2c521d242472278a4bc81de512bc2e0abac3c17bba8f3d4725c?d=identicon)[ganti](/maintainers/ganti) --- Top Contributors [![ganti](https://avatars.githubusercontent.com/u/28899559?v=4)](https://github.com/ganti "ganti (29 commits)")[![Mika-](https://avatars.githubusercontent.com/u/5081253?v=4)](https://github.com/Mika- "Mika- (26 commits)")[![sinnwell](https://avatars.githubusercontent.com/u/1050182?v=4)](https://github.com/sinnwell "sinnwell (5 commits)")[![ideadapt](https://avatars.githubusercontent.com/u/1071386?v=4)](https://github.com/ideadapt "ideadapt (2 commits)")[![JosefMor](https://avatars.githubusercontent.com/u/3066976?v=4)](https://github.com/JosefMor "JosefMor (2 commits)") ### Embed Badge ![Health badge](/badges/ganti-i18next-php/health.svg) ``` [![Health](https://phpackages.com/badges/ganti-i18next-php/health.svg)](https://phpackages.com/packages/ganti-i18next-php) ``` ### Alternatives [symfony/translation Provides tools to internationalize your application 6.6k836.5M2.1k](/packages/symfony-translation)[nesbot/carbon An API extension for DateTime that supports 281 different languages. 169661.4M4.8k](/packages/nesbot-carbon)[joedixon/laravel-translation A tool for managing all of your Laravel translations 717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation The Illuminate Translation package. 6936.4M495](/packages/illuminate-translation)[lajax/yii2-translate-manager Translation management extension for Yii 2 227578.8k13](/packages/lajax-yii2-translate-manager)[larswiegers/laravel-translations-checker Make sure your laravel translations are checked and are included in all languages. 256423.2k2](/packages/larswiegers-laravel-translations-checker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)