PHPackages yasir011/translation - 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. yasir011/translation ActiveLibrary[Localization & i18n](/categories/localization) yasir011/translation ==================== A Translation package for Laravel 5 with database and cache support 1.0(12y ago)018MITPHPPHP >=5.3.0 Since Nov 25Pushed 11y ago1 watchersCompare [ Source](https://github.com/yasir011/translation)[ Packagist](https://packagist.org/packages/yasir011/translation)[ RSS](/packages/yasir011-translation/feed)WikiDiscussions master Synced today READMEChangelogDependencies (4)Versions (4)Used By (0) Upgrading Laravel's localization module --------------------------------------- [](#upgrading-laravels-localization-module) Keeping a project's translations properly updated is cumbersome. Usually translators do not have access to the codebase, and even when they do it's hard to keep track of which translations are missing for each language or when updates to the original text require that translations be revised. This package allows developers to leverage their database and cache to manage multilanguage sites, while still working on language files during development and benefiting from all the features Laravel's Translation bundle has, like pluralization or replacement. Installation ------------ [](#installation) Edit composer.json: ``` "require": { "Yasir011/translation": "*" }, "repositories": [ { "type": "vcs", "url": "git@github.com:Yasir011/translation.git" } ``` \], In app/config/app.php, replace the following entry from the providers array: ``` 'Illuminate\Translation\TranslationServiceProvider' ``` with: ``` 'Yasir011\Translation\TranslationServiceProvider' ``` Execute the database migrations: ``` php artisan migrate --package=Yasir011/translation ``` You may publish the package's configuration if you so choose: ``` php artisan config:publish Yasir011/translation ``` Usage ----- [](#usage) This translations bundle is designed to adapt to your workflow. Translations are accessed just like in Laravel, with replacements and pluralization working as expected. The only difference is how your translations are managed. ### Modes of operation [](#modes-of-operation) You may configure the mode of operation through the config.php file. You may choose the one most appropiate for your workflow and environment. #### File based [](#file-based) If you do not wish to leverage your database for translations, you may choose to load language lines exclusively through language files. This mode differs from Laravel in that, in case a line is not found in the specified locale, instead of returning the key right away, we first check the default language for an entry. Example: ``` The content in en/validations.php is: array( 'missing_name' => 'Name is missing', 'missing_surname' => 'Surname is missing', ); The content in es/validations.php is: array( 'missing_name' => 'Falta el nombre', ); Output for different keys with es locale: Lang::get('validations.missing_name') -> 'Falta el nombre' Lang::get('validations.missing_surname') -> 'Surname is missing' Lang::get('validations.missing_email') -> 'missing_email' ``` #### Database [](#database) You may choose to load translations exclusively from the database. If you leverage your cache, this might be the best option when the site is live and you allow translators to add and update language entries through the database. In order to use the database mode of operation you must: - Run the migrations detailed in the installation instructions. - Add your languages of choice to the database. - Load your language files into the database using `php artisan translator:load` Example: ``` The content in the languages table is: | id | locale | name | ------------------------- | 1 | en | english | | 2 | es | spanish | The relevant content in the language_entries table is: | id | language_id | namespace | group | item | text | --------------------------------------------------------------------------------------------- | 1 | 1 | NULL | validations | missing_name | Name is missing | | 2 | 2 | NULL | validations | missing_surname | Surname is missing | | 3 | 1 | NULL | validations | min_number | Number is too small | | 4 | 2 | NULL | validations | missing_name | No se ha indicado nombre | | 5 | 2 | NULL | validations | missing_surname | No se ha indicado apellido | Output for different keys with es locale: Lang::get('validations.missing_name') -> 'No se ha indicado nombre' Lang::get('validations.min_number') -> 'Number is too small' Lang::get('validations.missing_email') -> 'missing_email' ``` #### Mixed mode [](#mixed-mode) In mixed mode, both the language files and the database are queried when looking for a group of language lines. Entries found in the filesystem take precedence over the database. Example: ``` When the content of the language files and the database is the same as in the previous two examples, this is the output for Lang::get: Lang::get('validations.missing_name') -> 'Falta el nombre' Lang::get('validations.missing_surname') -> 'No se ha indicado apellido' Lang::get('validations.min_number') -> 'Number is too small' Lang::get('validations.missing_email') -> 'missing_email' ``` #### Auto mode (default) [](#auto-mode-default) When in auto mode, the mode of operation is set by the value of 'debug' in app/config/app.php. When true, mixed mode is selected. When false, database mode is selected. ### Loading your files into the database [](#loading-your-files-into-the-database) When uploading your code to the live site, you must load your file contents into the database if you're using either the auto, database or mixed modes of operations. To refresh your database you may use the following artisan command: ``` php artisan translator:load ``` When loading the contents of the language files, non-existing entries will be added and existing ones will be updated (nothing is erased by default, you'll see why). In case the text on a default locale entry is updated, its current translations are flagged as 'unstable' so as to signal that a translator should check them to see if they're still valid. This is useful when small changes in the text shouldn't be reflected in the translations, or these are still somewhat valid despite the fact of not having been updated. Caching results --------------- [](#caching-results) Since querying the database everytime a language group must be loaded is grossly inefficient, you may choose to leverage Laravel's cache system. This module will use the same cache configuration as defined by you in app/config/cache.php. By default, the cache will be deactivated if the value of 'debug' in app/config/app.php is true, and activated when debug is false. You may customize this behaviour in the package's config file. Entries in the cache will be prefixed with 'Yasir011|translation|' The models ---------- [](#the-models) If you need to extend either the Language Model or the LanguageEntry model, you will need to extend both of them since they reference eachother. Once you've created your own models, remember to update the config file. For example, should you define your models as Language and LanguageEntry in /app/models you will have to edit the config file so its contents are: ``` /* |-------------------------------------------------------------------------- | Language |-------------------------------------------------------------------------- | | Configuration specific to the language management component. You may extend | the default models or implement their corresponding interfaces if you need to. | */ 'language' => array( 'model' => 'Language', ), 'language_entry' => array( 'model' => 'LanguageEntry', ), ``` ### Health Score 26 — LowBetter than 41% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community11 Small or concentrated contributor base Maturity60 Established project with proven stability 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. ### Release Activity Cadence Every ~163 days Total 2 Last Release 4441d ago Major Versions 0.9 → 1.02014-05-07 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1515902?v=4)[yasir011](/maintainers/yasir011)[@yasir011](https://github.com/yasir011) --- Top Contributors [![dylian94](https://avatars.githubusercontent.com/u/5433980?v=4)](https://github.com/dylian94 "dylian94 (4 commits)")[![yasir011](https://avatars.githubusercontent.com/u/1515902?v=4)](https://github.com/yasir011 "yasir011 (4 commits)")[![AlexRegenbogen](https://avatars.githubusercontent.com/u/242872?v=4)](https://github.com/AlexRegenbogen "AlexRegenbogen (1 commits)")[![ockle](https://avatars.githubusercontent.com/u/2755069?v=4)](https://github.com/ockle "ockle (1 commits)") ### Embed Badge ![Health badge](/badges/yasir011-translation/health.svg) ``` [![Health](https://phpackages.com/badges/yasir011-translation/health.svg)](https://phpackages.com/packages/yasir011-translation) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[laravel/ai The official AI SDK for Laravel. 1.0k3.2M201](/packages/laravel-ai)[yajra/laravel-oci8 Oracle DB driver for Laravel via OCI8 8793.2M25](/packages/yajra-laravel-oci8)[mike-bronner/laravel-model-caching Automatic caching for Eloquent models. 2.4k91.9k1](/packages/mike-bronner-laravel-model-caching)[glushkovds/phpclickhouse-laravel Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel 2051.5M2](/packages/glushkovds-phpclickhouse-laravel)[api-platform/laravel API Platform support for Laravel 58171.6k14](/packages/api-platform-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)