README

Laravel Lang Checker is a package for checking language files and translations in Laravel applications. It helps ensure that your translations are complete and consistent across different languages.

Requirements

• PHP 8.2, 8.3, 8.4, or 8.5
• Laravel 11, 12, or 13

Installation

You can install the package via composer:

composer require syntaxas/laravel-lang-checker

Usage

php artisan laravel-language:check

What It Checks

The command scans all locale directories under your lang/ path and runs the following checks:

Checks work recursively — files in subdirectories (e.g. /lang/lt/admin/dashboard.php) are included.

When the command fails, it reports the total number of issues found:

[ERROR] Language files check failed with 3 issue(s).

When everything is consistent:

[OK] Language files are consistent across all locales.

Examples

Missing translation key

lang/en/messages.php

return [
    'welcome' => 'Welcome',
    'goodbye' => 'Goodbye', // present in EN
];

lang/lt/messages.php

return [
    'welcome' => 'Sveiki',
    // 'goodbye' is missing
];

[ERROR] LT locale missing goodbye translation in messages.php

Missing file

lang/en/auth.php — exists
lang/lt/auth.php — missing

[ERROR] Missing file for locale LT: auth.php

Type mismatch

lang/en/messages.php

return [
    'nav' => [
        'home'  => 'Home',
        'about' => 'About',
    ],
];

lang/lt/messages.php

return [
    'nav' => 'Navigacija', // scalar instead of array
];

[ERROR] Type mismatch for key nav in messages.php (EN=array, LT=value)

Empty translation

lang/en/messages.php

return [
    'welcome' => '', // empty string
];

[WARNING] Empty translation in messages.php (EN): welcome

All correct

lang/en/messages.php

return [
    'welcome' => 'Welcome',
    'goodbye' => 'Goodbye',
];

lang/lt/messages.php

return [
    'welcome' => 'Sveiki',
    'goodbye' => 'Viso gero',
];

[OK] Language files are consistent across all locales.

Testing

composer test

License

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