Il processo di traduzione¶

Per tradurre il messaggio, Symfony2 utilizza un semplice processo:

• Viene determinato il locale dell'utente corrente, che è memorizzato nella richiesta (o nella sessione, come _locale);
• Un catalogo di messaggi tradotti viene caricato dalle risorse di traduzione definite per il locale (ad es. fr_FR). Vengono anche caricati i messaggi dal locale predefinito e aggiunti al catalogo, se non esistono già. Il risultato finale è un grande "dizionario" di traduzioni. Vedere i Cataloghi di messaggi per maggiori dettagli;
• Se il messaggio si trova nel catalogo, viene restituita la traduzione. Se no, il traduttore restituisce il messaggio originale.

Quando si usa il metodo trans(), Symfony2 cerca la stringa esatta all'interno del catalogo dei messaggi e la restituisce (se esiste).

Segnaposto per i messaggi¶

A volte, un messaggio contiene una variabile deve essere tradotta:

1
2
3
4
5
6
7
8
9

// ...
use Symfony\Component\HttpFoundation\Response;

public function indexAction($name)
{
    $t = $this->get('translator')->trans('Hello '.$name);

    return new Response($t);
}

Tuttavia, la creazione di una traduzione per questa stringa è impossibile, poiché il traduttore proverà a cercare il messaggio esatto, includendo le parti con le variabili (per esempio "Ciao Ryan" o "Ciao Fabien"). Invece di scrivere una traduzione per ogni possibile iterazione della variabile $name, si può sostituire la variabile con un "segnaposto":

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

// ...
use Symfony\Component\HttpFoundation\Response;

public function indexAction($name)
{
    $t = $this->get('translator')->trans(
        'Hello %name%',
        array('%name%' => $name)
    );

    return new Response($t);
}

Symfony2 cercherà ora una traduzione del messaggio di base (Hello %name%) e poi sostituirà i segnaposto con i loro valori. La creazione di una traduzione viene fatta esattamente come prima:

Come si è visto, la creazione di una traduzione è un processo in due fasi:

1. Astrarre il messaggio che si deve tradurre, processandolo tramite il Translator.
2. Creare una traduzione per il messaggio in ogni locale che si desideri supportare.

Il secondo passo si esegue creando cataloghi di messaggi, che definiscono le traduzioni per ogni diverso locale.

Sedi per le traduzioni e convenzioni sui nomi¶

Symfony2 cerca i file dei messaggi (ad esempio le traduzioni) in due sedi:

• la cartella <radice>/Resources/translations;
• la cartella <radice>/Resources/<bundle>/translations;
• la cartella Resources/translations/ del bundle.

I posti sono elencati in ordine di priorità. Quindi, si possono sovrascrivere i messaggi di traduzione di un bundle in una qualsiasi delle due cartelle superiori.

Il meccanismo di priorità si basa sulle chiavi: occoore dichiarare solamente le chiavi da sovrascrivere in un file di messaggi a priorià superiore. Se una chiave non viene trovata in un file di messaggi, il traduttore si appoggerà automaticamente ai file di messaggi a priorità inferiore.

È importante anche il nome del file con le traduzioni, perché Symfony2 utilizza una convenzione per determinare i dettagli sulle traduzioni. Ogni file con i messaggi deve essere nominato secondo il seguente schema: dominio.locale.caricatore:

• dominio: Un modo opzionale per organizzare i messaggi in gruppi (ad esempio admin, navigation o il predefinito messages) - vedere Uso dei domini per i messaggi;
• locale: Il locale per cui sono state scritte le traduzioni (ad esempio en_GB, en, ecc.);
• caricatore: Come Symfony2 dovrebbe caricare e analizzare il file (ad esempio xliff, php o yml).

Il caricatore può essere il nome di un qualunque caricatore registrato. Per impostazione predefinita, Symfony fornisce i seguenti caricatori:

• xliff: file XLIFF;
• php: file PHP;
• yml: file YAML.

La scelta di quali caricatori utilizzare è interamente a carico dello sviluppatore ed è una questione di gusti.

Creazione delle traduzioni¶

La creazione di file di traduzione è una parte importante della "localizzazione" (spesso abbreviata in L10n). Ogni file è costituito da una serie di coppie id-traduzione per il dato dominio e locale. L'id è l'identificativo di una traduzione individuale e può essere il messaggio nel locale principale (ad es. "Symfony is great") dell'applicazione o un identificatore univoci (ad es. "symfony2.great" - vedere la barra laterale di seguito):

Symfony2 troverà questi file e li utilizzerà quando dovrà tradurre "Symfony2 is great" o "symfony2.great" in un locale di lingua francese (ad es. fr_FR o fr_BE).

1
2
3

$t = $translator->trans('Symfony2 is great');

$t = $translator->trans('symfony2.great');

Fallback e locale predefinito¶

Se il locale non è stato impostato in modo esplicito nella sessione, sarà utilizzato dal Translator il parametro di configurazione fallback_locale. Il valore predefinito del parametro è en (vedere Configurazione).

In alternativa, è possibile garantire che un locale è impostato sulla sessione dell'utente definendo un default_locale per il servizio di sessione:

New in version 2.1: Il parametro default_locale era originariamente definito sotto la chiave session. Tuttavia, dalla 2.1 è stato spostato. Questo perché il locale è ora impostato nella richiesta, invece che nella sessione.

Il locale e gli URL¶

Dal momento che si può memorizzare il locale dell'utente nella sessione, si può essere tentati di utilizzare lo stesso URL per visualizzare una risorsa in più lingue in base al locale dell'utente. Per esempio, http://www.example.com/contact può mostrare contenuti in inglese per un utente e in francese per un altro. Purtroppo questo viola una fondamentale regola del web: un particolare URL deve restituire la stessa risorsa indipendentemente dall'utente. Inoltre, quale versione del contenuto dovrebbe essere indicizzata dai motori di ricerca?

Una politica migliore è quella di includere il locale nell'URL. Questo è completamente dal sistema delle rotte utilizzando il parametro speciale _locale:

Quando si utilizza il parametro speciale _locale in una rotta, il locale corrispondente verrà automaticamente impostato sulla sessione dell'utente. In altre parole, se un utente visita l'URI /fr/contact, il locale fr viene impostato automaticamente come locale per la sessione dell'utente.

È ora possibile utilizzare il locale dell'utente per creare rotte ad altre pagine tradotte nell'applicazione.

Intervallo di pluralizzazione esplicito¶

Il modo più semplice per pluralizzare un messaggio è quello di lasciare che Symfony2 utilizzi la sua logica interna per scegliere quale stringa utilizzare sulla base di un dato numero. A volte c'è bisogno di più controllo o si vuole una traduzione diversa per casi specifici (per 0, o quando il conteggio è negativo, ad esempio). In tali casi, è possibile utilizzare espliciti intervalli matematici:

1

'{0} There are no apples|{1} There is one apple|]1,19] There are %count% apples|[20,Inf] There are many apples'

Gli intervalli seguono la notazione ISO 31-11. La suddetta stringa specifica quattro diversi intervalli: esattamente 0, esattamente 1, 2-19 e 20 e superiori.

È inoltre possibile combinare le regole matematiche e le regole standard. In questo caso, se il numero non corrisponde a un intervallo specifico, le regole standard hanno effetto dopo aver rimosso le regole esplicite:

1

'{0} There is no apples|[20,Inf] There are many apples|There is one apple|a_few: There are %count% apples'

Ad esempio, per 1 mela, verrà usata la regola standard C'è una mela. Per 2-19 mele, verrà utilizzata la seconda regola standard Ci sono %count% mele.

Interval può rappresentare un insieme finito di numeri:

1

{1,2,3,4}

O numeri tra due numeri:

1
2

[1, +Inf[
]-1,2[

Il delimitatore di sinistra può essere [ (incluso) o ] (escluso). Il delimitatore di destra può essere [ (escluso) o ] (incluso). Oltre ai numeri, si può usare -Inf e +Inf per l'infinito.

Template Twig¶

Symfony2 fornisce dei tag specifici per Twig (trans e transchoice) per aiutare nella traduzione di messaggi con blocchi statici di testo:

1
2
3
4
5

{% trans %}Hello %name%{% endtrans %}

{% transchoice count %}
    {0} There are no apples|{1} There is one apple|]1,Inf] There are %count% apples
{% endtranschoice %}

Il tag transchoice ottiene automaticamente la variabile %count% dal contesto corrente e la passa al traduttore. Questo meccanismo funziona solo quando si utilizza un segnaposto che segue lo schema %var%.

È inoltre possibile specificare il dominio del messaggio e passare alcune variabili aggiuntive:

1
2
3
4
5
6
7

{% trans with {'%name%': 'Fabien'} from "app" %}Hello %name%{% endtrans %}

{% trans with {'%name%': 'Fabien'} from "app" into "fr" %}Hello %name%{% endtrans %}

{% transchoice count with {'%name%': 'Fabien'} from "app" %}
    {0} There is no apples|{1} There is one apple|]1,Inf] There are %count% apples
{% endtranschoice %}

I filtri trans e transchoice possono essere usati per tradurre variabili di testo ed espressioni complesse:

1
2
3
4
5
6
7

{{ message|trans }}

{{ message|transchoice(5) }}

{{ message|trans({'%name%': 'Fabien'}, "app") }}

{{ message|transchoice(5, {'%name%': 'Fabien'}, 'app') }}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{# il testo tradotto tra i tag non è mai sotto escape #}
{% trans %}
    <h3>pippo</h3>
{% endtrans %}

{% set message = '<h3>foo</h3>' %}

{# una variabile tradotta tramite filtro è sotto escape per impostazione predefinita #}
{{ message|trans|raw }}
{{ '<h3>pluto</h3>'|trans|raw }}

New in version 2.1: Il tag trans_default_domain è nuovo in Symfony2.1

Template PHP¶

Il servizio di traduzione è accessibile nei template PHP attraverso l'helper translator:

1
2
3
4
5
6
7

<?php echo $view['translator']->trans('Symfony2 is great') ?>

<?php echo $view['translator']->transChoice(
    '{0} There is no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
    10,
    array('%count%' => 10)
) ?>