Laravel Localization

Tempo de leitura: 3 minutos

Laravel Localization: A localização (localization) em aplicações web permite que você adapte sua aplicação para diferentes idiomas e regiões, oferecendo uma experiência mais personalizada aos seus usuários. O Laravel facilita a implementação de funcionalidades de localização, fornecendo ferramentas e recursos que simplificam a criação de aplicações multilíngues.

Neste artigo, vamos explorar os principais conceitos e ferramentas para implementar a localização em suas aplicações Laravel, abordando tópicos como publicação de arquivos de linguagem, configuração do locale e pluralização.

Publicando o arquivo de idiomas

O primeiro passo para criar uma aplicação multilíngue no Laravel é publicar os arquivos de idiomas. Esses arquivos contêm as traduções para as diferentes frases e textos que aparecem na sua aplicação.

Para publicar os arquivos de linguagem, execute o seguinte comando no terminal:

Bash

php artisan lang:publish

Este comando criará um diretório lang na raiz do seu projeto e copiará os arquivos de idioma padrão do Laravel. Você pode então personalizar esses arquivos para adicionar suas próprias traduções.

Configurando o locale

A configuração do locale define o idioma padrão da sua aplicação. Você pode configurar o locale no arquivo config/app.php:

PHP

'locale' => 'pt-BR',

Para alterar o locale durante a execução da aplicação, você pode utilizar a função App::setLocale():

PHP

use Illuminate\Support\Facades\App;

App::setLocale('en');

Pluralização da linguagem

A pluralização é o processo de adaptar uma frase para diferentes quantidades. O Laravel suporta a pluralização através de arquivos de linguagem. Você pode definir regras de pluralização para diferentes idiomas utilizando a sintaxe de pluralização do Gettext.

PHP

// lang/en/messages.php
'apples' => '{count} apple|{count} apples',

Para usar a pluralização em suas views, você pode utilizar a função trans_choice:

PHP

{{ trans_choice('messages.apples', $count) }}

Customizando os Arquivos de Idioma

Você pode criar seus próprios arquivos de idioma para adicionar traduções personalizadas. Por exemplo, para criar um arquivo de linguagem para o português brasileiro, você pode criar um arquivo lang/pt-BR/messages.php:

PHP

return [
    'welcome' => 'Bem-vindo!',
    'hello' => 'Olá, :name',
];

Para acessar as traduções em suas views, utilize a função trans:

PHP

{{ trans('messages.welcome') }}

Localização em Rotas e Controladores

Você pode passar o locale como parâmetro para rotas e controladores para permitir que o usuário escolha o idioma:

PHP

Route::get('{locale}', function ($locale) {
    App::setLocale($locale);
    // ...
});

Localização em Formulários

Para localizar os rótulos e mensagens de erro de formulários, você pode utilizar a função trans dentro das suas views:

HTML

<label for="name">{{ trans('validation.attributes.name') }}</label>

Localização em Pacotes

Se você estiver utilizando pacotes de terceiros, verifique se eles oferecem suporte à localização. Muitos pacotes permitem que você publique seus próprios arquivos de linguagem para personalizar as traduções.

Conclusão

Laravel Localization: A localização é uma funcionalidade essencial para aplicações web que visam alcançar um público global. O Laravel oferece um conjunto de ferramentas poderosas para implementar a localização de forma eficiente e fácil.

Ao seguir as dicas e exemplos apresentados neste artigo, você poderá criar aplicações multilíngues que proporcionam uma experiência personalizada aos seus usuários.

Mas antes de dominar o Laravel, se for o seu caso, toda jornada tem um início. Vamos entender quais são os conhecimentos básicos necessários para aproveitar ao máximo este poderoso framework. Para iniciar seus estudos no Laravel, você precisará dominar as seguintes tecnologias: