bottelet/translation-checker

A translation checker package for Laravel, find, add, and translate missing strings

2.0.0 2025-12-30 15:34 UTC

Requires

• php: ^8.2
• nikic/php-parser: ^v5.4
• openai-php/client: >=0.14.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.75
• orchestra/testbench: 10.8.0
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^9.4|^10.1|^11.0

MIT

• Casper Bottelet

README

Easily translate missing translations with AI, find missing translations you forgot to add to your language files, and maintain translations in your project. It provides a set of commands to help with language files, ensuring consistency and completeness across your translations. It works with Laravel and supports various frontend frameworks like Vue.js, React, and Svelte.

This package is only intended for Laravel's recommended approach to handle translation files. See Laravel Docs

How it works

1. Scan Source Files: The system looks through your code for strings that need translation.
2. Check Language Files: It then checks if these strings exist in your language files.
3. Use AI to translate missing keys: It adds the missing key with empty values if there is no translation service used.

Example:

lang.json

{
  "test.value": "Value"
}

lang.php

return [
  'test.value' => 'Value',
];

TestClass.php

class TestClass
{
    public function getValue()
    {
        return __('translate this string');
    }
}

php artisan translations:check en

lang.json

{
  "test.value": "Value",
  "translate this string": null
}

lang.php

return [
  'test.value' => 'Value',
  'translate this string' => null,
];

The reason we default to null when no translation service are used is because it defaults to the key used in the function call.

Quick Start

Install the package via composer:

  composer require bottelet/translation-checker --dev

Usage

Translation Checker provides several commands to manage your translations. The most versatile is the check command:

  php artisan translations:check en 

You can also easily find all sync translations between all files:

  php artisan translations:sync en

This will take all translations from the source files and sync them to all your other language files.

For detailed information on all available commands and their usage, refer to the documentation.

Testing

Run the tests with:

  ./vendor/bin/phpunit

Run PHPStan to check for code quality:

  ./vendor/bin/phpstan

Documentation

For full documentation, visit our GitHub documentation page.

If you encounter any issues or have suggestions, please create an issue on GitHub.

License

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