PHPackages hibasabouh/laravel-model-translations - 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. [Database & ORM](/categories/database) 4. / 5. hibasabouh/laravel-model-translations ActiveLibrary[Database & ORM](/categories/database) hibasabouh/laravel-model-translations ===================================== Database-driven model translations for Laravel using separate translation tables. v1.1.0(3mo ago)03MITPHPPHP ^8.1 Since Feb 19Pushed 3mo agoCompare [ Source](https://github.com/hibasabouh/laravel-model-translations)[ Packagist](https://packagist.org/packages/hibasabouh/laravel-model-translations)[ Docs](https://github.com/hibasabouh/laravel-model-translations)[ RSS](/packages/hibasabouh-laravel-model-translations/feed)WikiDiscussions main Synced today READMEChangelogDependencies (10)Versions (3)Used By (0) Laravel Model Translations ========================== [](#laravel-model-translations) [![Latest Version on Packagist](https://camo.githubusercontent.com/726d5b35e8eeca3bf4802cd9fd7f27a132e1e16ff4c863c5106ddce6e6d874c1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686962617361626f75682f6c61726176656c2d6d6f64656c2d7472616e736c6174696f6e732e737667)](https://packagist.org/packages/hibasabouh/laravel-model-translations)[![Total Downloads](https://camo.githubusercontent.com/cdf7820457763cdccb67d20d8cdad330dbe38f1fe6256a8a4919eb2cecc68852/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686962617361626f75682f6c61726176656c2d6d6f64656c2d7472616e736c6174696f6e732e737667)](https://packagist.org/packages/hibasabouh/laravel-model-translations)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![PHP](https://camo.githubusercontent.com/2bcd22c3d92a101d2d2272998e34fa018468ed602686f16783ec3a4122770215/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f686962617361626f75682f6c61726176656c2d6d6f64656c2d7472616e736c6174696f6e732e737667)](https://packagist.org/packages/hibasabouh/laravel-model-translations) A clean, database-driven approach to model translations in Laravel. Store translations in separate normalized tables and access them with elegant, locale-aware magic accessors. Why This Package? ----------------- [](#why-this-package) Unlike JSON-based translation approaches, this package: ✅ **Relational structure** — Translations live in proper normalized tables ✅ **Query support** — Filter models by translated content with `whereTranslation()` ✅ **Indexing & constraints** — Add database indexes and unique constraints per locale ✅ **Scalability** — Handles large datasets better than JSON columns ✅ **Clean models** — Keeps base model focused, translations separated If you prefer structured, relational translation tables over JSON columns, this package is for you. --- Requirements ------------ [](#requirements) LaravelPHP10.x^8.111.x^8.212.x^8.2--- Quick Start ----------- [](#quick-start) **1. Install** ``` composer require hibasabouh/laravel-model-translations ``` **2. Add the trait & define `$translatable`** ``` use HibaSabouh\ModelTranslations\Traits\HasTranslations; class Product extends Model { use HasTranslations; protected array $translatable = ['name', 'description']; } ``` **3. Create translation table** ``` Schema::create('product_translations', function (Blueprint $table) { $table->id(); $table->foreignId('product_id')->constrained()->cascadeOnDelete(); $table->string('lang', 10); $table->string('name'); $table->text('description')->nullable(); $table->timestamps(); $table->unique(['product_id', 'lang']); }); ``` **4. Create & access translations** ``` Product::createWithTranslations([ 'sku' => 'LAPTOP-001', 'name' => ['en' => 'Laptop', 'fr' => 'Ordinateur'], ]); app()->setLocale('fr'); echo $product->name; // "Ordinateur" ``` **Done!** --- Features -------- [](#features) - 🌍 **Locale-aware accessors** — `$model->name` automatically returns the current locale's value - 🔄 **Fallback strategies** — Choose between `null`, app fallback, or first available translation - 🔍 **Query scopes** — `whereTranslation()`, `whereAnyTranslation()` for filtering by translated content - 💾 **Transactional CRUD** — All operations wrapped in database transactions - 🎯 **Convention over configuration** — Auto-resolves translation model names - ⚡ **Eager loading** — Configurable auto-eager-loading via global scope - 🛠️ **Artisan command** — Scaffold translated models with a single command --- Installation ------------ [](#installation) ``` composer require hibasabouh/laravel-model-translations ``` ### Publish Configuration [](#publish-configuration) ``` php artisan vendor:publish --tag=translatable-config ``` This creates `config/translatable.php`: ``` return [ 'auto_load' => true, // Eager load translations globally 'fallback' => 'app', // Fallback strategy: null, 'app', or 'first' ]; ``` --- Artisan Command --------------- [](#artisan-command) The package ships with a `translations:make-model` command that scaffolds everything you need in one step: the main model, the translation model (in the `Translations` sub-namespace), and optionally a migration and resource controller. ### Basic Usage [](#basic-usage) ``` php artisan translations:make-model Product ``` This creates: - `app/Models/Product.php` — with `HasTranslations` trait and `$translatable` property pre-configured - `app/Models/Translations/ProductTranslation.php` — with `$fillable` set to `['product_id', 'lang']` ### Options [](#options) OptionDescription`--m`Create migrations for both the main model and its translation table`--r`Create a resource controller for the main model`--mr`Create both migration and resource controller``` # With migration php artisan translations:make-model Product --m # With resource controller php artisan translations:make-model Product --r # With both php artisan translations:make-model Product --mr ``` ### What Gets Generated [](#what-gets-generated) **When `--m` is used**, the translation migration is pre-filled with the expected structure: ``` Schema::create('product_translations', function (Blueprint $table) { $table->id(); $table->foreignId('product_id') ->constrained() ->cascadeOnDelete(); $table->string('lang'); $table->timestamps(); }); ``` You only need to add your translatable columns (e.g. `name`, `description`) — the foreign key, `lang`, and timestamps are already there. **The main model** is set up with the trait and empty stubs ready to fill: ``` use HibaSabouh\ModelTranslations\Traits\HasTranslations; class Product extends Model { use HasTranslations; protected $fillable = []; protected $translatable = []; } ``` **The translation model** has `$fillable` bootstrapped with the foreign key and locale columns: ``` class ProductTranslation extends Model { protected $fillable = [ 'product_id', 'lang', ]; } ``` > After running the command, add your translatable column names to both the migration and the `$fillable` / `$translatable` arrays. --- Setup Guide ----------- [](#setup-guide) ### 1. Migration: Create Translation Table [](#1-migration-create-translation-table) For each translatable model, create a corresponding `{model}_translations` table: ``` Schema::create('product_translations', function (Blueprint $table) { $table->id(); $table->foreignId('product_id')->constrained()->cascadeOnDelete(); $table->string('lang', 10); $table->string('name'); $table->text('description')->nullable(); $table->timestamps(); $table->unique(['product_id', 'lang']); // One translation per locale $table->index('lang'); // Optional: speed up locale-specific queries }); ``` ### 2. Translation Model [](#2-translation-model) Create a translation model in the `Translations` sub-namespace: ``` namespace App\Models\Translations; use Illuminate\Database\Eloquent\Model; class ProductTranslation extends Model { protected $fillable = ['product_id', 'lang', 'name', 'description']; } ``` > **Convention:** A `App\Models\Product` model resolves to `App\Models\Translations\ProductTranslation`. ### 3. Add Trait to Main Model [](#3-add-trait-to-main-model) ``` namespace App\Models; use HibaSabouh\ModelTranslations\Traits\HasTranslations; use Illuminate\Database\Eloquent\Model; class Product extends Model { use HasTranslations; protected $fillable = ['sku', 'price', 'stock']; protected array $translatable = ['name', 'description']; } ``` --- Usage ----- [](#usage) ### Creating Models [](#creating-models) Pass translatable attributes as arrays keyed by locale: ``` Product::createWithTranslations([ 'sku' => 'LAPTOP-001', 'price' => 999, 'name' => [ 'en' => 'Gaming Laptop', 'fr' => 'Ordinateur Portable de Jeu', 'ar' => 'حاسوب محمول للألعاب', ], 'description' => [ 'en' => 'High-performance laptop for gaming', 'fr' => 'Ordinateur haute performance pour les jeux', ], ]); ``` ### Updating Models [](#updating-models) ``` $product->updateWithTranslations([ 'price' => 899, // Update base attribute 'name' => [ 'en' => 'Gaming Laptop Pro', // Update existing 'de' => 'Gaming-Laptop', // Add new locale ], ]); // Untouched translations ('fr', 'ar') remain unchanged ``` ### Reading Translations [](#reading-translations) **Locale-aware accessor:** ``` app()->setLocale('fr'); echo $product->name; // "Ordinateur Portable de Jeu" ``` **All translations at once:** ``` $product->name_translations; // ['en' => 'Gaming Laptop', 'fr' => 'Ordinateur Portable de Jeu', 'ar' => '...'] ``` **Direct relationship access:** ``` $product->translations; // Collection of all ProductTranslation records $product->translations()->where('lang', 'en')->first(); ``` ### Querying by Translation [](#querying-by-translation) **Current locale (default):** ``` app()->setLocale('en'); Product::whereTranslation('name', 'like', '%Laptop%')->get(); ``` **Specific locale:** ``` Product::whereTranslation('name', 'Ordinateur', '=', 'fr')->get(); ``` **Any locale:** ``` Product::whereAnyTranslation('name', 'like', '%Laptop%')->get(); ``` **Chaining with OR:** ``` Product::where('price', ' 'Laptop']); // ✅ Valid Product::createWithTranslations(['name' => ['en' => 'Laptop']]); ``` Throws `InvalidTranslationFormatException` with a clear message: ``` The 'name' attribute must be an array of translations in the format: ['locale' => 'value']. ``` --- Testing ------- [](#testing) ``` composer test ``` --- Changelog --------- [](#changelog) See [CHANGELOG.md](CHANGELOG.md) for release history. --- Contributing ------------ [](#contributing) Contributions are welcome! Please: 1. Fork the repo 2. Create a feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request --- License ------- [](#license) The MIT License (MIT). See [LICENSE](LICENSE) for details. --- Credits ------- [](#credits) - **Hiba Sabouh** — [GitHub](https://github.com/hibasabouh) - All contributors --- Support ------- [](#support) - **Issues:** [GitHub Issues](https://github.com/hibasabouh/laravel-model-translations/issues) - **Source:** [GitHub Repository](https://github.com/hibasabouh/laravel-model-translations) ### Health Score 35 — LowBetter than 77% of packages Maintenance80 Actively maintained with recent releases Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~32 days Total 2 Last Release 103d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b008db9cadac70e99d017d3e5a3840289301499704e56f6384c558ad04f2b38d?d=identicon)[hibasabouh](/maintainers/hibasabouh) --- Top Contributors [![hibasabouh](https://avatars.githubusercontent.com/u/75159535?v=4)](https://github.com/hibasabouh "hibasabouh (8 commits)") --- Tags laravellocalizationi18ntranslationsmodeleloquent ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/hibasabouh-laravel-model-translations/health.svg) ``` [![Health](https://phpackages.com/badges/hibasabouh-laravel-model-translations/health.svg)](https://phpackages.com/packages/hibasabouh-laravel-model-translations) ``` ### Alternatives [mongodb/laravel-mongodb A MongoDB based Eloquent model and Query builder for Laravel 7.1k8.4M96](/packages/mongodb-laravel-mongodb)[kirschbaum-development/eloquent-power-joins The Laravel magic applied to joins. 1.6k32.6M46](/packages/kirschbaum-development-eloquent-power-joins)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[yajra/laravel-oci8 Oracle DB driver for Laravel via OCI8 8793.2M25](/packages/yajra-laravel-oci8)[spiritix/lada-cache A Redis based, automated and scalable database caching layer for Laravel 592456.3k2](/packages/spiritix-lada-cache)[glushkovds/phpclickhouse-laravel Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel 2051.5M2](/packages/glushkovds-phpclickhouse-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)