Laravel é uma ferramenta poderosa que permite aos desenvolvedores criar sites multilíngues. Ao implementar a localização web em seus Laravel , você pode fornecer uma experiência de usuário personalizada para visitantes de diferentes origens linguísticas, expandindo seu alcance e melhorando o envolvimento do usuário.
Orientaremos você na implementação da localização em sua aplicação Laravel e apresentaremos uma ferramenta que pode simplificar e aprimorar seus esforços de localização!
Aqui estão alguns motivos importantes pelos quais você deve localizar seu site Laravel .
Existem alguns requisitos e etapas a serem considerados ao implementar a localização multilíngue no Laravel .
Depois de entender quais requisitos devem ser atendidos antes de traduzir uma aplicação ou web Laravel , forneceremos alguns passos para traduzir Laravel de forma simples.
Para fazer isso, abra o arquivo de visualização que deseja localizar, por exemplo, resources/views/welcome.blade.php. Em seguida, substitua a tag body pelo código a seguir.
<body class="antialiased"> <div class="relative flex items-top justify-center min-h-screen bg-gray-100 sm:items-center py-4 sm:pt-0"> <div class="max-w-6xl mx-auto sm:px-6 lg:px-8"> <div class="flex justify-center pt-8 sm:justify-start sm:pt-0"> Welcome to Linguise website! </div> </div> </div> </body>
Como você pode ver, o texto acima está escrito diretamente no código. Isto é menos eficiente e dificulta a tradução de websites para diferentes idiomas (internacionalização).
Vamos flexibilizar o texto acima para que possa ser facilmente adaptado a diferentes idiomas. Laravel oferece um recurso muito útil para isso; o sistema de localização. Como primeira etapa, substitua o texto existente pelo código a seguir.
{{ __('Welcome to Linguise website!') }}
Laravel exibirá o texto acima por padrão e procurará a tradução se o usuário selecionar um idioma diferente do inglês. Neste caso, o inglês será utilizado como idioma padrão do aplicativo.
Mas como Laravel determina o idioma atual ou sabe quais idiomas estão disponíveis na aplicação? Ele verifica as configurações de localidade no arquivo config/app.php. Abra este arquivo e procure as duas chaves a seguir.
/* |-------------------------------------------------------------------------- | Application Locale Configuration |-------------------------------------------------------------------------- | | The application locale determines the default locale that will be used | by the translation service provider. You are free to set this value | to any of the locales which will be supported by the application. | */ 'locale' => 'en', /* |-------------------------------------------------------------------------- | Application Fallback Locale |-------------------------------------------------------------------------- | | The fallback locale determines the locale to use when the current one | is not available. You may change the value to correspond to any of | the language folders that are provided through your application. | */ 'fallback_locale' => 'en',
A explicação acima das chaves deve ser clara. Em resumo, a chave de localidade contém a localidade padrão do seu aplicativo (se nenhuma outra localidade for especificada no código). O fallback_locale é ativado se uma localidade inexistente for solicitada em sua aplicação.
Agora, vamos adicionar uma nova chave a este arquivo para fornecer uma lista de todas as localidades suportadas.
/* |-------------------------------------------------------------------------- | Available locales |-------------------------------------------------------------------------- | | List all locales that your application works with | */ 'available_locales' => [ 'English' => 'en', 'Italian' => 'it', 'French' => 'fr', ],
Neste ponto, tentamos Laravel web para suportar três idiomas, nomeadamente inglês, italiano e francês.
No Laravel , como em muitos outros frameworks, as traduções para diferentes idiomas são armazenadas em arquivos separados. Dois métodos são usados para organizar esses arquivos de tradução.
O método mais antigo armazena arquivos na seguinte estrutura: resources/lang/{en,fr,it}/{myfile.php}. O método mais recente usa arquivos JSON, como resources/lang/{fr.json, it.json}. Este artigo se concentrará no método mais recente, embora os princípios sejam semelhantes para o método mais antigo, exceto pelas diferenças na forma como as chaves de tradução são nomeadas e acessadas.
Para idiomas com variações regionais, você deve nomear os diretórios ou arquivos de idiomas de acordo com o padrão ISO 15897. Por exemplo, o inglês britânico seria denominado en_GB em vez de en-gb.
No Laravel , assim como em muitos frameworks, as traduções para diferentes idiomas são armazenadas em arquivos separados. Existem dois métodos principais para organizar arquivos de tradução Laravel .
Este artigo se concentrará no segundo método, embora os princípios sejam aplicáveis a ambos (com variações na forma como as chaves de tradução são nomeadas e acessadas).
Para idiomas que variam de acordo com a região, é recomendado nomear diretórios/arquivos de idiomas de acordo com os padrões ISO 15897. Por exemplo, o inglês britânico seria denotado como en_GB em vez de en-gb.
Depois de configurar as localidades de nosso aplicativo, podemos prosseguir com a tradução de nossa mensagem de boas-vindas padrão.
Vamos começar criando novos arquivos de localização no formato JSON no diretório resources/lang. Primeiro, criaremos um arquivo resources/lang/it.json e o preencheremos com as traduções apropriadas.
{ "Welcome to Linguise website!": "Benvenuti nel sito web di Linguise!" }
Em seguida, adicione um arquivo resources/lang/fr.json.
{ "Welcome to Linguise website!": "Bienvenue sur le site de Linguise" }
Como você pode observar, estamos referenciando consistentemente a mensagem padrão do arquivo Welcome.blade.php ({{ __('Bem-vindo ao site Linguise !') }}). Não há necessidade de criar um arquivo en.json, pois Laravel reconhece automaticamente que as mensagens padrão estão em inglês.
Além disso, Laravel ainda não está configurado para substituir o idioma local, então, por enquanto, iremos tratar da tradução diretamente na rota. Modifique a rota de boas-vindas padrão dentro do arquivo Routes/web.php assim.
Route::get('/{locale?}', function ($locale = null) { if (isset($locale) && in_array($locale, config('app.available_locales'))) { app()->setLocale($locale); } return view('welcome'); });
Nesse caso, estamos capturando um parâmetro GET de localidade opcional e definindo a localidade atual com base nele (se a localidade solicitada for suportada).
Agora você pode visitar seu site e incluir qualquer um dos idiomas suportados como o primeiro segmento no URL. Por exemplo, navegar para localhost/it ou localhost/fr exibirá o conteúdo localizado. Se você não especificar um local ou escolher um que não seja suportado, Laravel usará como padrão o inglês (en).
Incluir a localidade em cada URL pode não ser ideal e prejudicar o apelo visual do site. Para resolver isso, configuraremos um alternador de idioma e utilizaremos a sessão do usuário para exibir o conteúdo traduzido. Você pode criar um novo middleware no arquivo app/Http/Middleware/Localization.php ou gerá-lo executando o comando artesão make:middleware Localization.
Em seguida, adicione o seguinte código dentro.
<?php namespace App\Http\Middleware; use Closure; use Illuminate\Http\Request; use Illuminate\Support\Facades\App; use Illuminate\Support\Facades\Session; class Localization { /** * Handle an incoming request. * * @param \Illuminate\Http\Request $request * @param \Closure $next * @return mixed */ public function handle(Request $request, Closure $next) { if (Session::has('locale')) { App::setLocale(Session::get('locale')); } return $next($request); } }
Este middleware irá direcionar Laravel para usar o local selecionado pelo usuário se esta opção estiver presente na sessão.
Como precisamos que a operação seja executada em cada solicitação, adicione-a à pilha de middleware padrão em app/Http/Kernel.php para o grupo de middleware da web.
/** * The application's route middleware groups. * * @var array<string, array<int, class-string|string>> */ protected $middlewareGroups = [ 'web' => [ \App\Http\Middleware\EncryptCookies::class, \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class, \Illuminate\Session\Middleware\StartSession::class, \Illuminate\View\Middleware\ShareErrorsFromSession::class, \App\Http\Middleware\VerifyCsrfToken::class, \Illuminate\Routing\Middleware\SubstituteBindings::class, \App\Http\Middleware\Localization::class, // <--- add this ],
A seguir, defina uma rota para alterar a localidade no arquivo Routes/web.php. Estamos usando uma rota de encerramento aqui, mas você pode colocar o mesmo código dentro de um controlador, se preferir.
Route::get('language/{locale}', function ($locale) { app()->setLocale($locale); session()->put('locale', $locale); return redirect()->back(); });
Além disso, remova a alternância de localidade que foi adicionada anteriormente à rota de boas-vindas padrão. Sua rota raiz agora deve ficar assim.
Route::get('/', function () { return view('welcome'); });
Feito isso, o usuário só poderá mudar o idioma ativo visitando localhost/idioma/{locale}. A localidade selecionada será salva na sessão e os usuários serão redirecionados de volta à página anterior (conforme tratado pelo middleware de localização).
Para testá-lo, vá para localhost/idioma/it (assumindo que o cookie de sessão esteja ativo em seu navegador) e você deverá ver o conteúdo traduzido. Você pode navegar no site ou atualizar a página e o idioma escolhido permanecerá em vigor.
Agora, precisamos fornecer ao usuário uma opção clicável para alterar o alternador de idioma Laravel web, em vez de exigir que ele insira códigos de localidade na URL manualmente. Para conseguir isso, crie um alternador de idioma simples. Adicione um novo arquivo em resources/views/partials/language_switcher.blade.php e insira o seguinte código.
<div class="flex justify-center pt-8 sm:justify-start sm:pt-0"> @foreach($available_locales as $locale_name => $available_locale) @if($available_locale === $current_locale) <span class="ml-2 mr-2 text-gray-700">{{ $locale_name }}</span> @else <a class="ml-1 underline ml-2 mr-2" href="language/{{ $available_locale }}"> <span>{{ $locale_name }}</span> </a> @endif @endforeach </div>
Para incluir o alternador de idioma recém-criado na visualização “boas-vindas”, basta adicionar a seguinte linha ao seu arquivo Welcome.blade.php onde deseja que o alternador apareça.
<body class="antialiased"> <div class="relative flex items-top justify-center min-h-screen bg-gray-100 sm:items-center py-4 sm:pt-0"> <div class="max-w-6xl mx-auto sm:px-6 lg:px-8"> @include('partials/language_switcher') <div class="flex justify-center pt-8 sm:justify-start sm:pt-0"> {{ __('Welcome to our website!') }} </div> </div> </div> </body>
Abra o arquivo app/Providers/AppServiceProvider.php e adicione o seguinte código no método boot() para compartilhar a localidade atual com todas as visualizações quando o alternador de idioma for usado
* Bootstrap any application services. * * @return void */ public function boot() { view()->composer('partials.language_switcher', function ($view) { $view->with('current_locale', app()->getLocale()); $view->with('available_locales', config('app.available_locales')); }); }
Nesta discussão, iremos então lidar com outros componentes de localização, nomeadamente data, número e moeda. Aqui estão as etapas.
O manuseio de datas e horários é crucial no processo de localização. Laravel usa Carbon para gerenciar datas e horas. Veja como você pode usar o Carbon para exibir uma data localizada.
<?php Route::get('/', function () { $today = \Carbon\Carbon::now() ->settings( [ 'locale' => app()->getLocale(), ] ); // LL is macro placeholder for MMMM D, YYYY (you could write same as dddd, MMMM D, YYYY) $dateMessage = $today->isoFormat('dddd, LL'); return view('welcome', [ 'date_message' => $dateMessage ]); });
Este código define a localidade do Carbon com base na localidade atual do aplicativo e formata a data de acordo.
Para exibir a data localizada em uma visualização:
{{ __('Welcome to our website, :Name', ['name' => ‘Johb’]) }} <br> {{ trans_choice('{0} There :form :count apples|{1} There :form just :count apple|[2,19] There :form :count apples', 1, ['form' => 'is']) }} <br> {{ $date_message }}
Diferentes países têm várias formas de formatar números. Por exemplo.
Para acomodar essas variações em sua aplicação Laravel , você pode usar NumberFormatter.
<?php $num = NumberFormatter::create('en_US', NumberFormatter::DECIMAL); $num2 = NumberFormatter::create('fr', NumberFormatter::DECIMAL);
Você também pode soletrar números em um idioma específico.
<?php $num = NumberFormatter::create('en_US', NumberFormatter::SPELLOUT); $num2 = NumberFormatter::create('it', NumberFormatter::SPELLOUT);
Aqui estão as moedas. Para a localidade francesa (`fr`), a moeda será exibida em euros (€), enquanto para a localidade dos EUA (`en_US`), será mostrada em dólares americanos ($).
<?php $currency1 = NumberFormatter::create('it', NumberFormatter::CURRENCY); $currency2 = NumberFormatter::create('en_US', NumberFormatter::CURRENCY);
Depois de compreender as etapas de localização Laravel conforme descritas no artigo, este processo envolve muitas etapas que exigem que os usuários entendam profundamente o código do programa Laravel .
Isso certamente pode dificultar a localização de seus aplicativos para usuários novatos. Portanto, é necessária uma solução mais inovadora, capaz de tradução rápida, que suporte localização e que exija apenas alguns passos simples para ser implementada.
Uma solução promissora é Linguise . Linguise oferece uma abordagem mais fácil e eficiente para localização Laravel sem a necessidade de conhecimento profundo de codificação. Os principais recursos do Linguise incluem.
As etapas para instalar Linguise em sites Laravel também podem ser executadas facilmente. Aqui está uma breve explicação.
Como? Com Linguise , você só precisa se registrar e ativar, e o alternador de idiomas aparecerá. Depois disso, você está livre para localizar, por exemplo, através do editor ao vivo, traduzir mídia, imagens, etc.
A localização Laravel é um recurso poderoso que permite aos desenvolvedores criar sites e aplicativos multilíngues. Como vimos, o processo de localização integrado Laravel envolve várias etapas e requer um bom entendimento do framework. Pode ser um desafio para iniciantes ou para quem procura uma solução mais rápida.
Ferramentas como Linguise oferecem uma alternativa inovadora para quem busca uma abordagem mais simplificada. Essas soluções oferecem recursos de tradução rápida, fácil integração e recursos fáceis de usar, como alternadores de idioma personalizáveis e tradução de imagens. Agora, crie sua conta Linguise e aproveite nosso recurso para localizar seu Laravel !
Receba notícias sobre tradução automática de sites, SEO internacional e muito mais!
Não saia sem compartilhar seu e-mail!
Não podemos garantir que você ganhará na loteria, mas podemos prometer algumas notícias informativas interessantes sobre tradução e descontos ocasionais.
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/FI_Step-by-Step-Laravel-Localization.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Why-should-you-localize-the-Laravel-website-.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Requirements-for-a-multilingual-Laravel-localization.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Simple-Laravel-translations.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Setting-up-locales-in-a-Laravel-multilingual-web.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Laravel-translation-files-overview.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Language-switcher-in-a-Laravel-multilingual-app.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Advanced-translation-features-in-Laravel-PHP.png)
![Localização passo a passo Laravel [Guia]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Laravel-localization-with-Linguise.png)
