Stars: 197
Forks: 27
Pull Requests: 36
Issues: 21
Watchers: 3
Last Updated: 2023-09-03 12:51:36
Scan your Laravel project and generate language files ready to translate in language(s) of choosing.
License: Other
Languages: PHP
Localizator is a small tool for Laravel that gives you the ability to extract untranslated string from your project files with one command.
Laravel | Localizator |
---|---|
6.x LTS | ^0.3 |
8.x | * |
9.x | ^0.8 |
10.x | ^0.12 |
You can install the package via composer:
composer require --dev amirami/localizator
This package makes use of Laravels package auto-discovery mechanism, which means if you don't install dev dependencies in production, it also won't be loaded.
If for some reason you want manually control this:
extra.laravel.dont-discover
key in composer.json
, e.g.
"extra": {
"laravel": {
"dont-discover": [
"amirami/localizator"
]
}
}
providers
array in config/app.php
:
Amirami\Localizator\ServiceProvider::class,
AppServiceProvider
with the register()
method:
public function register()
{
if ($this->app->isLocal()) {
$this->app->register(\Amirami\Localizator\ServiceProvider::class);
}
// ...
}
Note: Avoid caching the configuration in your development environment, it may cause issues after installing this package; respectively clear the cache beforehand via
php artisan cache:clear
if you encounter problems when running the commands
You can publish the config file with:
php artisan vendor:publish --provider="Amirami\Localizator\ServiceProvider" --tag="config"
This is the contents of the published config file:
<?php
return [
/**
* Localize types of translation strings.
*/
'localize' => [
/**
* Short keys. This is the default for Laravel.
* They are stored in PHP files inside folders name by their locale code.
* Laravel comes with default: auth.php, pagination.php, passwords.php and validation.php
*/
'default' => true,
/**
* Translations strings as key.
* They are stored in JSON file for each locale.
*/
'json' => true,
],
/**
* Search criteria for files.
*/
'search' => [
/**
* Directories which should be looked inside.
*/
'dirs' => ['resources/views'],
/**
* Subdirectories which will be excluded.
* The values must be relative to the included directory paths.
*/
'exclude' => [
//
],
/**
* Patterns by which files should be queried.
* The values can be a regular expression, glob, or just a string.
*/
'patterns' => ['*.php'],
/**
* Functions that the strings will be extracted from.
* Add here any custom defined functions.
* NOTE: The translation string should always be the first argument.
*/
'functions' => ['__', 'trans', '@lang']
],
/**
* Should the localize command sort extracted strings alphabetically?
*/
'sort' => true,
];
To extract all the strings, it's as simple as running:
php artisan localize de,fr
This command will create (if don't exist) de.json
and fr.json
files inside the resources/lang
directory.
If you have short keys enabled and used in your files (e.g. pagination.next
) the localize command will create folders de
and fr
inside resources/lang
directory and PHP files inside by the short key's prefix (e.g. pagination.php
).
You can also run the artisan command without the country code arguments.
php artisan localize
In this case translation strings will be generated for the language specified in app.locale
config.
Note: Strings you have already translated will not be overwritten.
By default, the strings inside the locale files will be preserved even if they are not present the next time you run the localize command. If you want to remove those keys that are not present in your files anymore you can append the --remove-missing option to the localize command.
php artisan localize --remove-missing
By default, the strings generated inside those JSON files will be sorted alphabetically by their keys.
If you wanna turn off this feature just set sort => false
in the config file.
The way the strings are being extracted is simple.
We are looking inside the directories defined in search.dirs
config, we match the files using patterns defined in search.patterns
, and finally we look to extract strings
which are the first argument of the functions defined in search.functions
.
You are free to change any of these values inside the config file to suit you own needs.
composer test
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.