Symfony 2.4, el libro oficial

15.2. Traducción básica

La traducción de texto se realiza a través del servicio translator. Para traducir un bloque de texto (también llamado mensaje), se utiliza el método trans(). Supongamos, por ejemplo, que estás traduciendo un mensaje dentro de un controlador:

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

public function indexAction()
{
    $translated = $this->get('translator')->trans('Symfony2 is great');

    return new Response($translated);
}

Al ejecutar este código, Symfony2 trata de traducir el mensaje Symfony2 is great, basándose en el valor del locale del usuario. Para que la traducción se produzca, debes indicar a Symfony2 cómo traducir el texto mediante un "recurso de traducción", que normalmente consiste en un archivo que contiene una colección de traducciones para un determinado idioma. Este diccionario de traducciones se puede crear en diferentes formatos, pero el formato estándar XLIFF es el recomendado:

<!-- messages.fr.xliff -->
<?xml version="1.0"?>
<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
    <file source-language="en" datatype="plaintext" original="file.ext">
            <body>
            <trans-unit id="1">
                <source>Symfony2 is great</source>
                <target>J'aime Symfony2</target>
            </trans-unit>
        </body>
    </file>
</xliff>
// messages.fr.php
return array(
    'Symfony2 is great' => 'J\'aime Symfony2',
);
# messages.fr.yml
Symfony2 is great: "J'aime Symfony2"

Ahora, si el idioma del usuario es el francés (su locale es por ejemplo fr_FR o fr_BE), el mensaje será traducido a J'aime Symfony2.

15.2.1. El proceso de traducción

Symfony2 utiliza un proceso bastante sencillo para traducir los mensajes:

  • Determina el locale del usuario, que se encuentra almacenado en la petición.
  • Carga el catálogo de mensajes traducidos para ese locale (por ejemplo, fr_FR). También se cargan los mensajes del locale por defecto. El resultado es un gran diccionario de traducciones.
  • Si se encuentra el mensaje en el catálogo de traducciones, se devuelve la traducción. En caso contrario, el traductor devuelve el mensaje original.

Cuando se usa el método trans(), Symfony2 busca la cadena de texto exacta dentro del catálogo de mensajes y si existe, la devuelve.

15.2.2. Mensajes con variables

Resulta habitual que los mensajes a traducir contengan en su interior valores variables:

use Symfony\Component\HttpFoundation\Response;

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

    return new Response($translated);
}

Como el traductor siempre busca la cadena exacta, no es posible traducir este mensaje porque la variable $name puede tomar cualquier valor. En vez de escribir una traducción para cada posible valor de la variable $name, se puede reemplazar la variable por algo denominado placeholder o "marcador de posición".

Para conocer más detalles sobre cómo crear traducciones con variables, consulta el artículo Message Placeholders. Para saber cómo utilizar estas traducciones dentro de una plantilla, consulta el artículo Twig Templates.