2017 © Pedro Peláez
 

symfony-bundle google-translator-bundle

Symfony service designed to work with Google Translate API

image

zeliard91/google-translator-bundle

Symfony service designed to work with Google Translate API

  • Wednesday, September 27, 2017
  • by zeliard91
  • Repository
  • 1 Watchers
  • 1 Stars
  • 5,679 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 8 Versions
  • 35 % Grown

The README.md

PryonGoogleTranslatorBundle

SensioLabsInsight Build Status, (*1)

This bundle provides a symfony service to interact with Google Translate API. https://developers.google.com/translate/v2/getting_started, (*2)

To be able to translate sentences, you have to enable billing on your Google Cloud Console https://developers.google.com/translate/v2/pricing, (*3)

Installation

Installation is a quick 3 step process:, (*4)

  1. Download PryonGoogleTranslatorBundle using composer
  2. Enable the Bundle
  3. Configure your application's config.yml

Step 1: Download PryonGoogleTranslatorBundle using composer

``` bash php composer.phar require zeliard91/google-translator-bundle, (*5)



### Step 2: Enable the bundle

Enable the bundle in the kernel:

``` php
<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Pryon\GoogleTranslatorBundle\PryonGoogleTranslatorBundle(),
    );
}

Step 3: Add your Google API Key in configuration

``` yaml, (*6)

app/config/config.yml

pryon_google_translator: google_api_key: MySecretKey, (*7)


## Usage

The bundle provides a service to your app in order to call the Google Translate 
API in REST.

### Exemples

#### Get supported languages

``` php
<?php

$languages = $this->get('pryon.google.translator')->getSupportedLanguages();
//->['en','fr','de','it',...]

Translate sentences

``` php <?php, (*8)

$translation = $this->get('pryon.google.translator')->translate('en','fr','I love Symfony'); //->"J'adore Symfony", (*9)

$translations = $this->get('pryon.google.translator')->translate('en','fr', array('I love Symfony', 'I like PHP')); //->["J'adore Symfony", "J'aime PHP"], (*10)


Be aware that Google restricts the use of this service by limiting the size of the query 
at 5K caracteres with the POST method (and 2K in GET).
The number of queries is also limited to 128 if you pass an array for the third argument of the translate method.

The translate method detects if these limits are reached and call the API as many times 
as necessary which may result a long processing.


### Form Type

A "translatorlanguage" Form Type is also present in this bundle.
It is basically the same as the core "language" Form Type except from the choices list which is filled by the API.

``` php
<?php

use Pryon\GoogleTranslatorBundle\Form\Type\LanguageType;
use Symfony\Component\Form\FormBuilderInterface;

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        // ...
        ->add('source', LanguageType::class, array(
            'required' => true,
            'label' => 'Source language'
        ))
    ;
}

Cache

You can cache the responses of the API with one of the subclasses of Doctrine\Common\Cache\CacheProvider, (*11)

This can be done by specifying what you want to cache and with what in the configuration file. This is the default configuration :, (*12)

``` yaml, (*13)

app/config/config.yml

pryon_google_translator: cache: # Specify your doctrine cache service service: pryon.google.translator.array_cache_provider calls: # get available languages method languages: true # translate method translate: false, (*14)



## HTTP Client Options

You can define default HTTP headesr for the REST client hitting the Google API : 

``` yaml
# app/config/config.yml

pryon_google_translator:
    # ...
    client_options:
        headers:
            Referer: %router.request_context.scheme%://%router.request_context.host%%router.request_context.base_url%
            User-Agent: Mr Robot

See Guzzle doc for more information., (*15)

The Versions

27/09 2017

dev-master

9999999-dev https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Damien Matabon

api google translate zeliard91

27/09 2017

2.1.2

2.1.2.0 https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Damien Matabon

api google translate zeliard91

29/04 2017

2.1.1

2.1.1.0 https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Damien Matabon

api google translate zeliard91

29/04 2017

2.1.0

2.1.0.0 https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Damien Matabon

api google translate zeliard91

02/02 2016

2.0.0

2.0.0.0 https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony 2 service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Damien Matabon

api google translate zeliard91

28/09 2014

1.0.2

1.0.2.0 https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony 2 service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

by Damien Matabon

api google translate zeliard91

28/09 2014

1.0.1

1.0.1.0 https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony 2 service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

by Damien Matabon

api google translate zeliard91

28/03 2014

1.0.0

1.0.0.0 https://github.com/zeliard91/PryonGoogleTranslatorBundle

Symfony 2 service designed to work with Google Translate API

  Sources   Download

MIT

The Requires

 

by Damien Matabon

api google translate zeliard91