PHPackages mistralys/application-localization - 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. mistralys/application-localization ActiveLibrary[Localization & i18n](/categories/localization) mistralys/application-localization ================================== PHP and Javascript localization library. 2.1.2(7mo ago)28.0k↓33.3%[2 issues](https://github.com/Mistralys/application-localization/issues)7MITPHPPHP ^7.4|^8.0CI passing Since Oct 8Pushed 2mo ago4 watchersCompare [ Source](https://github.com/Mistralys/application-localization)[ Packagist](https://packagist.org/packages/mistralys/application-localization)[ RSS](/packages/mistralys-application-localization/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (8)Versions (23)Used By (7) Application Localization ======================== [](#application-localization) A PHP and JavaScript localization library that automatically discovers translatable strings in your source files and stores translations in simple INI files. Drop in the built-in editor UI and your team can start translating without touching code. Features -------- [](#features) - **Automatic string discovery** — scans PHP and JavaScript source files for translation function calls - **Built-in translator UI** — a ready-made editor that integrates into any existing interface - **Clientside translations** — auto-generated JavaScript include files bring `t()` to the browser - **Translation context** — optional context strings help translators understand ambiguous texts - **Countries, locales & currencies** — classes for 19 countries, 18 locales, 10 currencies, and 21 time zones with country-specific formatting - **Locale alias handling** — automatically normalizes `uk`/`gb` and `en_UK`/`en_GB` mix-ups > **Scope note:** The included countries, locales, and currencies reflect what is commonly needed in typical european-centric web applications, not a complete i18n universe. See the [full list of supported countries and locales](docs/overview.md). Requirements ------------ [](#requirements) - PHP 8.4 or higher - [Composer](https://getcomposer.org/) Quick Start ----------- [](#quick-start) **1. Install via Composer** ``` composer require mistralys/application-localization ``` **2. Configure the library** ``` use AppLocalize\Localization; // Register the locales your app supports (english is the native locale) Localization::addAppLocale('de_DE'); Localization::addAppLocale('fr_FR'); // Register a source folder to scan for translatable strings Localization::addSourceFolder( 'my-app', 'My Application', 'Core', '/path/to/ini/files/', '/path/to/source/files/' ); // Finalize configuration (always last) Localization::configure('/path/to/cache.json'); ``` **3. Translate strings in PHP** ``` use function AppLocalize\t; use function AppLocalize\pt; $message = t('Welcome back, %1$s!', $username); pt('Save changes'); ``` **4. Translate strings in JavaScript** ``` var message = t('Welcome back, %1$s!', username); ``` **5. Switch the active locale** ``` Localization::selectAppLocale('de_DE'); ``` Learn More ---------- [](#learn-more) TopicDocumentFull setup walkthrough[Configuration Guide](docs/configuration.md)Translation functions, placeholders & best practices[Translation Functions](docs/translation-functions.md)Countries, currencies & time zones API[Countries, Currencies & Time Zones](docs/countries-currencies-timezones.md)Supported countries, locales & currencies[Supported countries and locales](docs/overview.md)Changelog[changelog.md](changelog.md)Packagist[mistralys/application-localization](https://packagist.org/packages/mistralys/application-localization)Example ------- [](#example) Run `composer update` in the package folder and open the `example/` directory in your browser (package must be inside your webserver's document root) to see the editor UI live. Origins ------- [](#origins) This library grew out of several internal applications before being extracted into a standalone package. It makes no claim of replacing established i18n libraries — it simply solves a specific set of localization needs cleanly and pragmatically. ### Health Score 47 — FairBetter than 94% of packages Maintenance57 Moderate activity, may be stable Popularity26 Limited adoption so far Community19 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 99.3% of commits — single point of failure 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. ### Release Activity Cadence Every ~122 days Recently: every ~36 days Total 19 Last Release 217d ago Major Versions 1.5.0 → 2.0.02025-05-21 PHP version history (3 changes)1.3.0PHP >=7.3 1.5.0PHP >=7.4 2.0.0PHP ^7.4|^8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/8895528?v=4)[Mistralys](/maintainers/Mistralys)[@Mistralys](https://github.com/Mistralys) --- Top Contributors [![Mistralys](https://avatars.githubusercontent.com/u/8895528?v=4)](https://github.com/Mistralys "Mistralys (448 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") --- Tags clientside-javascripti18ninternationalizationlanguagelibrarylocalizationphptranslationtranslator-appuser-interface ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/mistralys-application-localization/health.svg) ``` [![Health](https://phpackages.com/badges/mistralys-application-localization/health.svg)](https://phpackages.com/packages/mistralys-application-localization) ``` ### 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)