README

Lokale is a Laravel package designed to automatically extract and generate translation files by scanning your source code for translation keys. It also supports syncing translations between different locales.

🧩 Installation

Install the package using Composer:

composer require hsm/lokale

⚙️ Configuration

This package uses Laravel's package discovery. If for some reason it's not auto-discovered, register it manually:

'providers' => [
    Hsm\Lokale\LokaleServiceProvider::class,
];

🚀 Usage

1. Generate Locale Files

You can generate translation files by scanning your source code:

php artisan locale:make

Options

Example

php artisan locale:make --locale=fr --src=app --comment

This will generate files like:

resources/lang/fr/messages.php
resources/lang/fr/auth.php

Each file will contain translation keys extracted from __(), trans(), or trans_choice() usage across your source code.

2. Sync Between Locales

You can synchronize translation files between two locales using:

php artisan locale:sync --from=en --to=fr

Options

This is useful when adding new keys in one language and you want the same structure in another language.

3. Generate Attribute Translations

This command generates translation files for form request attributes:

php artisan locale:attributes --locale=fr

Options

This helps to keep validation error messages localized and consistent.

🧠 How It Works

• Scans PHP and Blade files for translation functions (__(), trans(), trans_choice()).
• Extracts keys and organizes them into proper translation files.
• Adds @TODO comments for untranslated placeholders when --comment is enabled.
• Generates modern, readable PHP array syntax.

📂 Output Example

resources/lang/fr/messages.php

<?php
/**
 * Generated with hsm/lokale
 */
return [
    'welcome' => 'Welcome',
    'greeting' => 'Greeting', // @TODO Add translation
];

👨‍💻 Author

• Amirhesam Bahmankhah
  📧 bahmankhah1@gmail.com

📄 License

MIT © Amirhesam Bahmankhah