PHPackages                             webo3/laravel-translator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. webo3/laravel-translator

ActiveLibrary[Localization & i18n](/categories/localization)

webo3/laravel-translator
========================

This package add artisan commands to scan/export/import translations.

v2.0.4(3mo ago)12.2k↑729.4%1MITPHPPHP ^7.3|^8.0

Since Oct 2Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/webo3/laravel-translator)[ Packagist](https://packagist.org/packages/webo3/laravel-translator)[ Docs](https://www.webo3.com)[ RSS](/packages/webo3-laravel-translator/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (2)Versions (7)Used By (0)

Laravel Translator
------------------

[](#laravel-translator)

A Laravel package that provides artisan commands to scan, export, import and auto-translate translation strings. It extracts translation keys from your source code, manages JSON language files, supports CSV and XLIFF workflows for working with translators, and can automatically translate using the Google Translate API.

### Supported translation functions

[](#supported-translation-functions)

FunctionFile typesExample`__()`PHP, JS, TS, Vue`__('Hello world')``Lang::get()`PHP`Lang::get('messages.welcome')``@lang()`PHP (Blade)`@lang('Please login')``$t()`JS, TS, Vue`$t('Vue key')``.t()`JS, TS, Vue`i18n.t('My key')`### Quote handling

[](#quote-handling)

- Single quotes: `__('key')`
- Double quotes: `__("key")`
- Escaped quotes: `__('It\'s a test')` correctly extracts `It's a test`
- Backtick template literals (JS/TS/Vue only): `__(`multi-line key`)`
- Backticks are ignored in PHP files (where they are the shell execution operator)

### Installation

[](#installation)

```
composer require webo3/laravel-translator
```

Package auto-discovery is enabled for Laravel >= 5.5. For older versions, register the provider manually in `config/app.php`:

```
'providers' => [
    webO3\Translator\Providers\TranslatorServiceProvider::class,
],
```

Configuration
-------------

[](#configuration)

Publish the configuration file to specify which languages to manage:

```
php artisan vendor:publish --provider="webO3\Translator\Providers\TranslatorServiceProvider" --tag=config
```

This creates `config/webo3-translator.php` with the following options:

```
return [
    // Languages to manage
    'languages' => ['en', 'fr'],

    // Where JSON language files are stored
    'lang_path' => resource_path('lang'),

    // Where export files are written (null = same as lang_path)
    'export_path' => null,

    // Directories to scan for translation keys
    'scan_paths' => [app_path(), resource_path()],

    // Export format: 'csv' or 'xliff'
    'format' => 'csv',

    // Translation driver for auto-translate: 'google_free'
    'translation_driver' => 'google_free',

    // Driver-specific options
    'translation_options' => [],
];
```

Usage
-----

[](#usage)

### 1. Scan and extract translations

[](#1-scan-and-extract-translations)

Scans `*.php`, `*.js`, `*.ts` and `*.vue` files in the configured `scan_paths` for translation function calls. Extracts unique keys and creates/updates a JSON file for each configured language.

```
php artisan translations:scan
```

- New keys are added with the key itself as the default value
- Existing translations are preserved
- Keys are sorted alphabetically
- Comments (`//` and `/* */`) are stripped before scanning, but `//` inside strings (e.g. URLs) is preserved

#### Clean unused keys

[](#clean-unused-keys)

Add the `--clean` option to detect and remove translation keys that are no longer used in your source files:

```
php artisan translations:scan --clean
```

This will scan your code, then compare existing keys in each language JSON file against the keys found in source. Unused keys are listed in a table and you are prompted for confirmation before they are removed.

### 2. Export translations

[](#2-export-translations)

Reads all language JSON files and exports them in the configured format.

```
php artisan translations:export
```

#### CSV format (default)

[](#csv-format-default)

Exports a single `translations.csv` file with a UTF-8 BOM for Excel compatibility:

keyenfrHello worldHello worldBonjour le mondeGoodbyeGoodbyeAu revoirUntranslated values (where the value equals the key) appear as empty cells.

#### XLIFF format

[](#xliff-format)

Set `'format' => 'xliff'` in your config. Exports one XLIFF 1.2 file per target language (e.g. `translations-fr.xlf`). The first language in your `languages` array is used as the source language.

XLIFF is the industry standard format supported by professional translation tools (SDL Trados, memoQ, Phrase, Crowdin, etc.).

### 3. Import translations

[](#3-import-translations)

Reads the exported file(s) and merges the translated values back into the JSON language files.

```
php artisan translations:import
```

- New keys are added
- Existing translations are updated if the file has a different value
- Empty values default to the key itself
- Keys are sorted alphabetically after import
- The import format is determined by the `format` config option (same as export)

### 4. Auto-translate with an API

[](#4-auto-translate-with-an-api)

Automatically translates untranslated keys using a translation API and saves the results directly to your JSON language files.

First, install the Google Translate package:

```
composer require stichoza/google-translate-php
```

Then run:

```
php artisan translations:translate
```

This translates all untranslated keys (where value equals the key) from the source language to every other configured language.

#### Options

[](#options)

OptionDescription`--lang=fr,es`Only translate specific target languages`--force`Re-translate keys that already have translations`--driver=google_free`Override the translation driver from config`--batch-size=50`Number of strings per API call (default: 50)#### Placeholder preservation

[](#placeholder-preservation)

The command automatically preserves Laravel and Vue placeholders during translation:

- Laravel style: `:name`, `:count`, `:attribute`
- Brace style: `{name}`, `{count}`, `{item}`

These are masked before sending to the API and restored in the translated result.

#### Case deduplication

[](#case-deduplication)

Keys that differ only in letter case (e.g. `"Hello"`, `"hello"`, `"HELLO"`) are deduplicated into a single API call. The translated result is then adjusted to match each variant's casing (uppercase, lowercase, title case).

#### Configuration

[](#configuration-1)

Two config keys control auto-translation:

```
// Translation driver: 'google_free'
'translation_driver' => 'google_free',

// Driver-specific options (reserved for future drivers)
'translation_options' => [
    // 'api_key' => env('TRANSLATION_API_KEY'),
],
```

#### Custom drivers

[](#custom-drivers)

You can register your own translation driver by binding it in the service container:

```
$this->app->singleton('translation.driver.my_driver', function () {
    return new MyCustomDriver(); // must implement TranslatorDriverInterface
});
```

Then use it with `--driver=my_driver` or set `'translation_driver' => 'my_driver'` in config.

### Typical workflow

[](#typical-workflow)

1. Write code using `__('key')`, `$t('key')`, etc.
2. Run `php artisan translations:scan` to extract all keys
3. Either:
    - **Auto-translate**: Run `php artisan translations:translate` to translate via API
    - **Manual workflow**: Export → send to translator → import:
        1. `php artisan translations:export`
        2. Send the file(s) to your translator
        3. `php artisan translations:import`

Using translations in Vue
-------------------------

[](#using-translations-in-vue)

Install the vue-i18n package:

```
npm install vue-i18n --save-dev
```

Set up vue-i18n in your `app.js`:

```
import { createI18n } from 'vue-i18n';
import en from '../lang/en.json';
import fr from '../lang/fr.json';

const i18n = createI18n({
    locale: 'en',
    messages: { en, fr }
});

app.use(i18n);
```

Then use `$t()` or `i18n.t()` in your templates:

```
{{ $t('Hello world') }}
```

Testing
-------

[](#testing)

```
composer test              # Run tests without coverage
composer test-coverage     # Run tests with coverage report
```

License
-------

[](#license)

MIT

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance78

Regular maintenance activity

Popularity24

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 95% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~323 days

Recently: every ~7 days

Total

6

Last Release

118d ago

Major Versions

v1.0.0 → v2.0.02026-02-07

PHP version history (2 changes)v1.0.0PHP >=7.0

v2.0.0PHP ^7.3|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/0a175e082beae5946d428cc9e5675c903fe5df3691351b6db3ec22eb6b2ea1ab?d=identicon)[moihuguesjoyal](/maintainers/moihuguesjoyal)

---

Top Contributors

[![huguesjoyal](https://avatars.githubusercontent.com/u/16695693?v=4)](https://github.com/huguesjoyal "huguesjoyal (19 commits)")[![slgo99](https://avatars.githubusercontent.com/u/48689110?v=4)](https://github.com/slgo99 "slgo99 (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/webo3-laravel-translator/health.svg)

```
[![Health](https://phpackages.com/badges/webo3-laravel-translator/health.svg)](https://phpackages.com/packages/webo3-laravel-translator)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)