Internacionalizar las aplicaciones Symfony

1. Locale, internacionalización y regionalización

Cualquier sitio web contiene una gran cantidad de datos textuales para que el usuario los lea. Si elimináramos todo el código informático de su proyecto, todavía habría una parte significativa de mensajes, textos y contenido en castellano dispersos por sus templates, controladores y bases de datos.

Si desea transformar su sitio web, que está exclusivamente en castellano, en un sitio web multiidioma, hay que modificar muchas capas de la aplicación. La tarea se puede volver difícil rápidamente o incluso hacer que su proyecto sea ilegible si no elige las herramientas adecuadas.

Afortunadamente, Symfony tiene un componente encargado de gestionar las traducciones de un sitio con flexibilidad y simplicidad. Antes de descubrirlo, primero es necesario definir algunos términos.

1. Las técnicas

1. El componente translator

Para establecer el sistema de traducción de Symfony, en primer lugar es necesario instalar el componente translator. Si ha creado su aplicación usando el modelo de aplicación (symfony/website-skeleton), entonces ya está instalado, pero, de lo contrario, ejecute la recipe Flex adecuada con el comando:

composer require symfony/translation 

2. Configuración del framework

El sistema de traducción proporcionado por el componente translator ofrece el archivo de configuración config/packages/translation.yaml con el siguiente contenido predeterminado:

# config/packages/translation.yaml  
framework:  
   default_locale: en  
   translator:  
       default_path: '%kernel.project_dir%/translations'  
       fallbacks:  
             en 

Contiene el locale predeterminado (default_locale) y el directorio de traducción predeterminado (default_path). Este es el directorio de traducciones ubicado en la raíz de su proyecto.

Obviamente, una primera adaptación importante de este archivo es ajustar el locale predeterminado de su aplicación: es es un buen valor si desea que su aplicación sea nativa en castellano.

También...

1. Organización y reglas de nomenclatura

Los archivos de traducción se deben guardar en el directorio translations/ del proyecto y deben seguir estrictas reglas de nomenclatura.

1. El servicio translator

El servicio translator se utiliza para traducir mensajes. Así es como se debe usar desde una acción:

...  
use Symfony\Contracts\Translation\TranslatorInterface;  
  
...  
  
public function hola(TranslatorInterface $translator)  
{  
   $mensaje = $translator->trans('Hola');  
   return new Response($mensaje);   
} 

Para traducir el mensaje al inglés, por ejemplo, debe crear el siguiente archivo de traducción:

# translations/messages.en.yaml  
 
Hola: Hello 

Si abre esta página con el locale en en la URL, verá «Hello» en la pantalla.

El archivo utiliza el dominio messages (y, por lo tanto, el archivo messages.en.yaml) porque es el dominio predeterminado. A continuación, le indicamos cómo usar otro durante la traducción:

$translator->trans('Hola', array(), 'el_dominio'); 

Aquí, se tendrá en cuenta el dominio el_dominio. Ahora veremos el papel de la tabla vacía que se pasa como segundo parámetro.

2. Marcadores de sustitución (placeholders)

Los parámetros de sustitución permiten crear mensajes dinámicos. Son similares a los parámetros de sustitución de las rutas.

Supongamos...