aurawindsurfing / google-translate
Free Laravel package for Paid Google Translate REST API with your own API key
Installs: 16 802
Dependents: 1
Suggesters: 0
Security: 0
Stars: 11
Watchers: 1
Forks: 6
Open Issues: 0
Requires
- php: >=7.4
- guzzlehttp/guzzle: ^7.0.1
Requires (Dev)
- phpunit/phpunit: ^5.2
This package is auto-updated.
Last update: 2024-10-29 05:22:38 UTC
README
Package allows to work with Google Translate API
Installation
Package can be installed using composer by adding to "require" object
"require": {
"aurawindsurfing/google-translate"
}
or from console:
composer require aurawindsurfing/google-translate
Configuration
After the installation, you should add "Dedicated\GoogleTranslate\GoogleTranslateProvider" to providers.
'providers' => [
/* 3rd Party Providers */
Dedicated\GoogleTranslate\GoogleTranslateProvider::class,
],
Then you should publish config file to be able to add your Google API key. To publish config you should do:
php artisan vendor:publish \
--provider="Dedicated\GoogleTranslate\GoogleTranslateProvider" --tag=config
After config is published, you will have it in config\google-translate.php
of your Laravel project directory
You should change only one line:
...
/**
* Google key for authentication
*/
'api_key' => 'YOUR-GOOGLE-API-KEY-GOES-HERE',
...
Usage
To translate text with given source language and target language:
$translator = new Dedicated\GoogleTranslate\Translator;
$result = $translator->setSourceLang('en')
->setTargetLang('ru')
->translate('Hello World');
dd($result); // "Привет мир"
By default language detection is turned on, so you can translate text without specifying source language.
This will make 2 requests to google API:
- First request will go to /detect URL and get source language name
- Second request will make actual translate request and give out result.
$translator = new Dedicated\GoogleTranslate\Translator;
$result = $translator->setTargetLang('ru')
->translate('Hello World');
dd($result); // "Привет мир"
You can also use function to only detect text's source language:
$result = $translator->detect('Hello World');
dd($result); // "en"
License
This repository code is open-sourced software licensed under the MIT license.