Laravel Google Translate

darvis/laravel-google-translate sends text, HTML or the fields of an Eloquent model to the Google Cloud Translation API and gives you the translation back. For a model it stores the translation as a new row in the same table, linked to the original through a pid column.

Who it is for

You have a Laravel application with content in one language, and you want a machine translation of it in other languages: pages in a CMS, products, news items, or loose strings.

A service for a string, a piece of HTML, a batch of strings or an array of fields.
A trait (a piece of code you add to a model with use) for Eloquent models that keep one row per locale.
A failed API call never throws. It is logged and returns null, so you check the return value instead of catching an exception.

What it does not do

It does not translate the language files in lang/, and it does not replace __().
It does not cache: the same loose string sent twice is translated twice.
It does not queue, retry or loop over your target locales. Your code decides when and to which locale it translates.
It does not add a translations table or JSON columns; a translation is a full row of its own.
It does not detect the source language. It always sends a source locale, from the config or from your call.
It uses the Cloud Translation API v2 (“Basic”) with an API key, not v3 with a service account.

Requirements

PHP 8.2 or higher
Laravel 11, 12 or 13 (Laravel 13 itself needs PHP 8.3)
A Google Cloud Translation API key, from a Google Cloud project with billing enabled

Install

composer require darvis/laravel-google-translate

GOOGLE_TRANSLATE_API_KEY=your-api-key
GOOGLE_TRANSLATE_SOURCE_LOCALE=nl

Installation explains where the key comes from and how to check that it works.

In short

use Darvis\LaravelGoogleTranslate\GoogleTranslateService;

$translator = app(GoogleTranslateService::class);

$translator->translate('Hallo wereld', 'en');            // for example "Hello world"
$translator->translateHtml('<p>Hallo</p>', 'en');        // for example "<p>Hello</p>"
$translator->translateBatch(['Hallo', 'Wereld'], 'en');  // for example ["Hello", "World"]

$english = $page->createTranslation('en');               // a new row, or null