codebar-ag/laravel-translations

Extract and manage Laravel translation keys from application source files.

v13.0 2026-03-19 15:06 UTC

Requires

• php: 8.5.*
• guzzlehttp/guzzle: ^7.10
• illuminate/contracts: ^13.0
• nesbot/carbon: ^3.11
• spatie/laravel-package-tools: ^1.93

Requires (Dev)

• larastan/larastan: ^3.9
• laravel/pint: ^1.29
• nunomaduro/collision: ^8.9
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/laravel-ray: ^1.43

MIT

• Rhys Lees

• i18n
• translations
• laravel
• localization

README

laravel-translations scans your application source files for __() translation keys and creates JSON language files. It also includes a conversion command that can replace path-based keys with their resolved inline text.

Requirements

Package	PHP	Laravel
current	8.5.*	13.x

Installation

You can install the package via composer:

composer require codebar-ag/laravel-translations

You can publish the config file with:

php artisan vendor:publish --tag="laravel-translations-config"

This is the contents of the published config file:

return [
    'pattern' => '/__\(\s*([\'"])(?<key>(?:\\\\.|(?!\1).)*)\1/',
    'directories' => [
        'app',
        'resources',
    ],
];

translations.directories controls where the scanner looks for translation keys. Use relative paths from your Laravel project root.

Commands

# Build lang/{locale}.json from __() usage
php artisan translations:fetch de

# Overwrite without confirmation
php artisan translations:fetch de --force

# Convert path-based keys to inline text in configured directories
php artisan translations:convert

# Preview conversion changes only
php artisan translations:convert --dry-run

Testing

composer test

Changelog

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

Credits

• Rhys Lees
• All Contributors

License

The MIT License (MIT). Please see License File for more information.