Trabalhando com internacionalização e localização no Symfony: como suportar vários idiomas

O que é internacionalização e localização?

Antes de entendermos como trabalhar com internacionalização e localização no Symfony, precisamos entender o que esses termos significam.

Internacionalização (i18n) é o processo de tornar um aplicativo localizável, ou seja, um aplicativo que pode ser facilmente traduzido para outros idiomas. Por outro lado, localização (l10n) é o processo de adaptar um aplicativo para uma região ou idioma específico, levando em consideração as diferenças culturais e lingüísticas dessa região.

Como trabalhar com internacionalização e localização no Symfony?

O Symfony tem suporte nativo à internacionalização e localização. Existem várias ferramentas que podem ser usadas para esse fim, mas a mais utilizada é a classe Translation do Symfony.

Para começar, devemos instalar a dependência do Symfony para a tradução. Isso pode ser feito executando o seguinte comando no terminal:

composer require symfony/translation

Depois disso, precisamos configurar o sistema de tradução do Symfony. O Symfony usa o YAML como formato para arquivos de tradução. Portanto, precisamos criar um diretório chamado translations em nosso diretório de configuração e criar um arquivo para cada idioma com as traduções necessárias.

Para usar a classe Translation, basta instanciá-la e chamar o método trans passando a string que deve ser traduzida. O Symfony então busca a tradução apropriada no arquivo de idioma correto.

Como usar traduções em templates?

Para usar traduções em templates, o Symfony fornece o filtro trans. Podemos usá-lo da seguinte maneira:

{{ 'hello'|trans }}

Isso traduzirá a string “hello” para o idioma correspondente. Podemos passar um segundo parâmetro opcional para o filtro trans para especificar o domínio de tradução. Um domínio é essencialmente um conjunto de strings traduzíveis que podem ser usadas em uma seção separada do aplicativo.

Conclusão

A internacionalização e localização são recursos importantes em qualquer aplicativo que tem como alvo um público global. O Symfony suporta esses recursos de forma nativa usando a classe Translation e arquivos de tradução YAML. Com a ajuda do filtro trans, podemos facilmente traduzir strings em nossos templates. Isso nos ajuda a criar aplicativos flexíveis e escaláveis que possam ser facilmente adaptados para diferentes regiões e culturas.