Skip to content

Laravel Larex lets you translate your whole Laravel application with a single CSV file.

License

Notifications You must be signed in to change notification settings

Lukasss93/laravel-larex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Laravel Larex

Version Downloads License PHP Laravel

Tests Test Coverage

Laravel Larex lets you translate your whole Laravel application with a single CSV file.

You can import translation entries from lang folder into a structured CSV, edit the translations and export them back to Laravel PHP files.

Laravel Larex also supports functionalities to sort entries and find strings that aren't localized yet.

See Plugins section for other features.

πŸš€ Installation

You can install the package using composer

composer require lukasss93/laravel-larex --dev

Then add the service provider to config/app.php.
This step can be skipped if package auto-discovery is enabled.

'providers' => [
    Lukasss93\Larex\LarexServiceProvider::class
];

βš™ Publishing the config file

Publishing the config file is optional:

php artisan vendor:publish --provider="Lukasss93\Larex\LarexServiceProvider" --tag="larex-config"

πŸ‘“ Usage

  1. First, you must create the initial CSV file with php artisan larex:init.
    Or you can use php artisan larex:import to import entries from lang folder.
    The csv file has the following columns:

    • group (basically the file name)
    • key (the array key)
    • en (the language code)
    • other language codes...
  2. Open the project-root/lang/localization.csv file and edit it as you see fit.

  3. Finally, you can use php artisan larex:export to translate your entries from the csv file to the laravel php files.

✨ Tips

  • You can import existing laravel php files with php artisan larex:import.
  • You can use php artisan larex:init --base to init the CSV file with default Laravel entries.
  • The key column inside the CSV file supports the dot notation for nested arrays.
  • You can watch your CSV file with php artisan larex:export --watch
  • You can use php artisan larex:sort to sort the CSV file by group and key.
  • Be careful when using the php artisan larex:export command! It will overwrite all files named with the group names inside the CSV.
  • Be careful when using the dot notation! Only the last entry will override the value.
  • You can use php artisan larex:insert to add new items via CLI too!
  • You can use php artisan larex:import --include=en,it to import only "en" and "it" items.
  • You can use php artisan larex:import --exclude=it to import all items except "it" item.
  • You can use php artisan larex:export --include=en,it to export only "en" and "it" columns.
  • You can use php artisan larex:export --exclude=it to export all columns except "it" column.
  • You can use php artisan larex:localize to find unlocalized strings (use the --import option to add strings in your CSV).
  • You can use php artisan larex:find to search existing groups or keys in your CSV file.
  • You can use php artisan larex:remove to remove existing strings in your CSV file.
  • You can use php artisan larex:lang:add to add a new language column to your CSV file.
  • You can use php artisan larex:lang:remove to remove a language column from your CSV file.
  • You can use php artisan larex:lang:order to reorder language columns in your CSV file.

πŸ“ Example

  1. Run php artisan larex:init command

  2. Edit the project-root/lang/localization.csv file

group key en it
app hello Hello Ciao
app list.developers Developers Sviluppatori
app list.teachers Teachers Insegnanti
  1. Run php artisan larex:export command

  2. You'll get the following files:

    //project-root/lang/en/app.php
    
    <?php
    
    return [
        'hello' => 'Hello',
        'list' => [
            'developers' => 'Developers',
            'teachers' => 'Teachers',
        ]
    ];
    //project-root/lang/it/app.php
    
    <?php
    
    return [
        'hello' => 'Ciao',
        'list' => [
            'developers' => 'Sviluppatori',
            'teachers' => 'Insegnanti',
        ]
    ];

⏫ Exporters

The larex:export <exporter> command exports CSV strings to a specific location based on the selected exporter.

Exporter Default Description
laravel βœ… Export data from CSV to Laravel localization files
json:group ❌ Export data from CSV to JSON by group
json:lang ❌ Export data from CSV to JSON by language
How to create an exporter:
  1. Create a class that implements the Lukasss93\Larex\Contracts\Exporter interface
  2. Add your exporter inside the larex config

⏬ Importers

The larex:import <importer> command imports the strings of the selected importer, into the CSV.

Importer Default Description
laravel βœ… Import data from Laravel localization files to CSV
json:group ❌ Import data from JSON by group to CSV
json:lang ❌ Import data from JSON by language to CSV
How to create an importer:
  1. Create a class that implements the Lukasss93\Larex\Contracts\Importer interface
  2. Add your importer inside the larex config

πŸ” Linters

Larex provides a linting system by using the php artisan larex:lint command to validate your CSV file.

Available linters:
Linter Enabled
by default
Description
ValidHeaderLinter βœ… Validate the header structure
ValidLanguageCodeLinter βœ… Validate the language codes in the header columns
DuplicateKeyLinter βœ… Find duplicated keys
ConcurrentKeyLinter βœ… Find concurrent keys
NoValueLinter βœ… Find missing values
DuplicateValueLinter βœ… Find duplicated values in the same row
UntranslatedStringsLinter ❌ Find untranslated strings
UntranslatedStringsLinter ❌ Find unused strings
ValidHtmlValueLinter ❌ Check valid html values
SameParametersLinter ❌ Check same parameters in each language

You can enable/disable any linter you want by comment/uncomment it inside the larex config.

How to create a linter:
  1. Create a class that implements the Lukasss93\Larex\Contracts\Linter interface
  2. Add your linter inside the larex config

🧩 Plugins

  • Crowdin Plugin
    A Laravel Larex plugin to import/export localization strings from/to Crowdin

βš—οΈ Testing

composer test

πŸ”° Version Support

Larex L5.8 L6.x L7.x L8.x L9.x L10.x L11.x
^1.0 βœ… βœ… βœ… βœ… ❌ ❌ ❌
^1.2 | ^2.0 ❌ βœ… βœ… βœ… ❌ ❌ ❌
^3.0 ❌ ❌ βœ… βœ… ❌ ❌ ❌
^4.0 ❌ ❌ ❌ βœ… βœ… βœ… βœ…
Larex PHP7.2 PHP7.3 PHP7.4 PHP8.0 PHP8.1 PHP8.2 PHP8.3
^1.0 βœ… βœ… βœ… ❌ ❌ ❌ ❌
^1.6 | ^2.0 ❌ βœ… βœ… βœ… βœ… ❌ ❌
^3.0 ❌ ❌ βœ… βœ… βœ… βœ… βœ…
^4.0 ❌ ❌ ❌ βœ… βœ… βœ… βœ…

πŸ“ƒ Changelog

Please see the CHANGELOG.md for more information on what has changed recently.

πŸ… Credits

πŸ“– License

Please see the LICENSE.md file for more information.

About

Laravel Larex lets you translate your whole Laravel application with a single CSV file.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project

 

Languages