Ghid pas cu pas pentru localizarea Laravel

Duceți-vă afacerea la următorul nivel cu expansiune globală. Creștere și dezvoltare a afacerii.
Cuprins

Laravel localization este un instrument puternic care le permite dezvoltatorilor să creeze site-uri web multilingve. Prin implementarea localizării web în proiectele tale Laravel , poți oferi o experiență personalizată utilizatorilor din medii lingvistice diferite, extinzându-ți astfel aria de acoperire și îmbunătățind implicarea utilizatorilor.

Vă vom ghida prin implementarea localizării în aplicația dvs. Laravel și vă vom prezenta un instrument care vă poate simplifica și îmbunătăți eforturile de localizare!

De ce ar trebui să localizați site-ul web Laravel ?

Un bărbat cu vestă portocalie ținând o tabletă cu o hartă a lumii. Sunt afișate diverse steaguri de țări.

Iată câteva motive importante pentru care ar trebui să localizați site-ul web Laravel .

  • Ajungeți la un public global: Prin localizarea site-ului dvs. Laravel , puteți extinde aria de acoperire a aplicației dvs. către un public internațional. Astfel, utilizatorii din diferite țări și medii lingvistice pot înțelege și interacționa cu conținutul dvs.
  • Îmbunătățește experiența utilizatorului: Localizarea permite utilizatorilor să interacționeze cu aplicația în limba lor maternă, ceea ce îmbunătățește semnificativ experiența utilizatorului. Acest lucru poate crește ratele de implicare, poate reduce rata de respingere și poate crește conversiile.
  • Avantaj competitiv: Pe o piață globală competitivă, oferirea aplicațiilor în mai multe limbi poate oferi un avantaj semnificativ față de concurenți. Acest lucru demonstrează angajamentul tău față de piețele internaționale și te poate ajuta să pătrunzi mai eficient pe piețe noi.
  • Îmbunătățește SEO: Site-urile web bine localizate tind să se claseze mai bine în motoarele de căutare pentru căutările într-o anumită limbă. Acest lucru poate crește traficul blogului dvs. și vizibilitatea online pe diverse piețe cu ajutorul traducerii multilingve.

Cerințe pentru o localizare multilingvă Laravel

Două persoane care colaborează pe un ecran mare de computer cu diverse aplicații. Se pare că lucrează împreună.

Există câteva cerințe și pași de luat în considerare atunci când implementați localizarea multilingvă în Laravel.

  • Pentru a obține cele mai recente funcționalități de localizare, asigurați-vă că utilizați cea mai recentă versiune de Laravel (de exemplu, versiunea 10.x).
  • O cunoaștere de bază a PHP și a framework-ului Laravel va fi utilă în procesul de implementare.
  • Configurați un mediu de dezvoltare local sau un server care acceptă Laravel, inclusiv un server web și o bază de date.
  • Stabilește încă de la început limbile pe care le va accepta aplicația ta.

Traduceri simple Laravel

Bărbat care lucrează la laptop. Navigare pe internet pe ecran.

După ce înțelegem ce cerințe trebuie îndeplinite înainte de a traduce o aplicație Laravel sau un site web, vom oferi câțiva pași pentru a traduce Laravel simplu.

Pentru a face acest lucru, deschideți fișierul de vizualizare pe care doriți să îl localizați, de exemplu, resources/views/welcome.blade.php. Apoi, înlocuiți eticheta body cu următorul cod.

				
					<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>
				
			

După cum puteți vedea, textul de mai sus este în prezent scris direct în cod. Acest lucru este mai puțin eficient și face dificilă traducerea site-urilor web în diferite limbi (internaționalizare). 

Vom face textul de mai sus mai flexibil, astfel încât să poată fi adaptat cu ușurință la diferite limbi. Laravel oferă o funcție foarte utilă în acest sens: sistemul de localizare. Ca prim pas, înlocuiți textul existent cu următorul cod.

				
					{{ __('Welcome to Linguise website!') }}
				
			

Laravel va afișa textul de mai sus în mod implicit și va căuta traducerea dacă utilizatorul selectează o altă limbă decât engleza. În acest caz, engleza va fi utilizată ca limbă implicită a aplicației.

Configurarea localizărilor într-un site web multilingv Laravel

Două persoane care lucrează la ecrane de computer. Interacționează cu ecrane mari.

Dar cum determină Laravel limba curentă sau cum știe ce limbi sunt disponibile în aplicație? Verifică setările de localizare din fișierul config/app.php. Deschideți acest fișier și căutați următoarele două chei.

				
					/*
|--------------------------------------------------------------------------
| 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',

				
			

Explicația de deasupra cheilor ar trebui să fie clară. Pe scurt, cheia regională conține regionala implicită pentru aplicația dvs. (dacă nu este specificată nicio altă regională în cod). fallback_locale este activată dacă în aplicația dvs. este solicitată o regională inexistentă.

Acum, haideți să adăugăm o cheie nouă la acest fișier pentru a oferi o listă cu toate setările regionale acceptate.

				
					/*
|--------------------------------------------------------------------------
| Available locales
|--------------------------------------------------------------------------
|
| List all locales that your application works with
|
*/

'available_locales' => [
  'English' => 'en',
  'Italian' => 'it',
  'French' => 'fr',
],


				
			

În acest moment, am încercat Laravel web pentru a accepta trei limbi, și anume engleză, italiană și franceză.

Prezentare generală a fișierelor de traducere Laravel

O femeie care arată spre un ecran mare de computer pe care sunt afișate diverse pictograme colorate. Ecranul are un fundal alb cu pictograme albastre și violet.

În Laravel, ca în multe alte framework-uri, traducerile pentru diferite limbi sunt stocate în fișiere separate. Pentru organizarea acestor fișiere de traducere sunt utilizate două metode.

Metoda mai veche stochează fișierele în următoarea structură: resources/lang/{en,fr,it}/{myfile.php}. Metoda mai nouă utilizează fișiere JSON, precum resources/lang/{fr.json, it.json}. Acest articol se va concentra pe metoda mai nouă, deși principiile sunt similare pentru metoda mai veche, cu excepția diferențelor privind modul în care sunt denumite și accesate cheile de traducere.

Pentru limbile cu variații regionale, ar trebui să denumiți directoarele sau fișierele lingvistice conform standardului ISO 15897. De exemplu, engleza britanică ar fi denumită en_GB în loc de en-gb.

Informații generale

În Laravel, ca în multe alte framework-uri, traducerile pentru diferite limbi sunt stocate în fișiere separate. Există două metode principale pentru organizarea fișierelor de traducere Laravel .

  1. Abordarea moștenită implică stocarea fișierelor sub calea: resources/lang/{en,fr,it}/{myfile.php}.
  2. Abordarea modernă utilizează fișierele resources/lang/{fr.json, it.json}.

Acest articol se va concentra pe a doua metodă, deși principiile sunt aplicabile ambelor (cu variații în modul în care cheile de traducere sunt denumite și accesate).

Pentru limbile care variază în funcție de regiune, se recomandă denumirea directoarelor/fișierelor de limbă conform standardelor ISO 15897. De exemplu, engleza britanică ar fi denumită en_GB în loc de en-gb.

Crearea fișierelor de traducere Laravel

După ce am configurat localizările pentru aplicația noastră, putem continua cu traducerea mesajului nostru de bun venit implicit.

Să începem prin a crea noi fișiere de localizare în format JSON în directorul resources/lang. Mai întâi, vom crea un fișier resources/lang/it.json și îl vom popula cu traducerile corespunzătoare.

				
					{
  "Welcome to Linguise website!": "Benvenuti nel sito web di Linguise!"
}

				
			

Apoi, adăugați un fișier resources/lang/fr.json.

				
					{
 "Welcome to Linguise website!": "Bienvenue sur le site de Linguise"
}

				
			

După cum puteți observa, facem referire constant la mesajul implicit din fișierul welcome.blade.php ({{ __('Bun venit pe site-ul Linguise !') }}). Nu este nevoie să creați un fișier en.json, deoarece Laravel recunoaște automat că mesajele implicite sunt în limba engleză.

Setarea comutatorului de limbă într-o aplicație multilingvă Laravel

Persoane care interacționează cu o interfață de e-mail de mari dimensiuni.

În plus, Laravel nu este încă configurat pentru a suprascrie limba locală, așa că deocamdată vom gestiona traducerea direct în cadrul rutei. Modifică ruta implicită de bun venit din fișierul routes/web.php astfel.

				
					Route::get('/{locale?}', function ($locale = null) {
    if (isset($locale) && in_array($locale, config('app.available_locales'))) {
        app()->setLocale($locale);
    }
    
    return view('welcome');
});
				
			

În acest caz, capturăm un parametru GET opțional pentru localizare și setăm localizarea curentă pe baza acestuia (dacă localizarea solicitată este acceptată).

Acum poți vizita site-ul tău web și poți include oricare dintre limbile acceptate ca prim segment în URL. De exemplu, navigarea la localhost/it sau localhost/fr va afișa conținutul localizat. Dacă nu specifici o localizare sau alegi una care nu este acceptată, Laravel va folosi implicit engleza (en).

Middleware de localizare pentru Laravel

Includerea setărilor regionale în fiecare adresă URL ar putea să nu fie ideală și ar putea afecta atractivitatea vizuală a site-ului. Pentru a remedia acest lucru, vom configura un comutator de limbă și vom utiliza sesiunea utilizatorului pentru a afișa conținutul tradus. Puteți crea middleware nou în fișierul app/Http/Middleware/Localization.php sau îl puteți genera rulând comanda artisan make:middleware Localization.

Apoi, adăugați următorul cod înăuntru.

				
					<?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);
    }
}


				
			

Acest middleware va direcționa Laravel să utilizeze locația selectată de utilizator dacă această opțiune este prezentă în sesiune.

Deoarece avem nevoie ca operațiunea să ruleze la fiecare cerere, adăugați-o la stiva implicită de middleware din app/Http/Kernel.php pentru grupul de middleware 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
],


				
			

Modificarea rutelor

Apoi, definiți o rută pentru a schimba localizarea în fișierul routes/web.php. Aici folosim o rută de tip closure, dar puteți plasa același cod într-un controller dacă preferați.

				
					Route::get('language/{locale}', function ($locale) {
   app()->setLocale($locale);
   session()->put('locale', $locale);
   return redirect()->back();
});

				
			

În plus, eliminați comutarea localizării care a fost adăugată anterior la ruta implicită de bun venit. Ruta dvs. rădăcină ar trebui să arate acum astfel.

				
					Route::get('/', function () {
   return view('welcome');
});

				
			

După ce acest lucru este făcut, utilizatorul poate schimba limba activă doar accesând localhost/language/{locale}. Setările regionale selectate vor fi salvate în sesiune, iar utilizatorii vor fi redirecționați înapoi la pagina anterioară (așa cum este gestionat de middleware-ul de localizare). 

Pentru a testa, accesați localhost/language/it (presupunând că cookie-ul de sesiune este activ în browserul dvs.) și ar trebui să vedeți conținutul tradus. Puteți naviga pe site sau reîmprospăta pagina, iar limba aleasă va rămâne activă.

Implementarea comutatorului de limbă

Acum, trebuie să oferim utilizatorului o opțiune pe care să poată da clic pentru a schimba comutatorul de limbă Laravel web în loc să îi solicităm să introducă manual codurile de localizare în URL. Pentru a realiza acest lucru, creați un comutator de limbă simplu. Adăugați un fișier nou la resources/views/partials/language_switcher.blade.php și inserați următorul cod.

				
					<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>


				
			

Pentru a include noul comutator de limbă creat în vizualizarea „welcome”, pur și simplu adăugați următoarea linie în fișierul dvs. welcome.blade.php acolo unde doriți să apară comutatorul.

				
					<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>


				
			

Deschideți fișierul app/Providers/AppServiceProvider.php și adăugați următorul cod în metoda boot() pentru a partaja setările regionale curente cu toate vizualizările atunci când se utilizează comutatorul de limbă

				
					* 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'));
    });
}


				
			

Funcții avansate de traducere în Laravel PHP

Ilustrație a unor persoane care lucrează la un proiect. O echipă care colaborează.

În această discuție, vom trata apoi alte componente de localizare, și anume data, numărul și moneda. Iată pașii.

Date localizate în Laravel

Gestionarea datelor și orelor este crucială în procesul de localizare. Laravel folosește Carbon pentru a gestiona datele și orele. Iată cum poți folosi Carbon pentru a afișa o dată localizată.

				
					<?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
    ]);
});


				
			

Acest cod setează setările regionale Carbon pe baza setărilor regionale curente ale aplicației și formatează data în consecință.

Pentru a afișa data localizată într-o vizualizare:

				
					{{ __('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 }}


				
			

Formatarea numerelor și a monedelor

Diferite țări au diferite metode de formatare a numerelor. De exemplu.

  • Franța → 123 123,12
  • Germania → 123.123,12
  • Japonia → 123.123

Pentru a acomoda aceste variații în aplicația Laravel , puteți utiliza NumberFormatter.

				
					<?php
$num = NumberFormatter::create('en_US', NumberFormatter::DECIMAL);

$num2 = NumberFormatter::create('fr', NumberFormatter::DECIMAL);
				
			

De asemenea, puteți scrie numere într-o anumită limbă.

				
					<?php
$num = NumberFormatter::create('en_US', NumberFormatter::SPELLOUT);

$num2 = NumberFormatter::create('it', NumberFormatter::SPELLOUT);
				
			

Iată monedele. Pentru setările regionale franceze (`fr`), moneda va fi afișată în euro (€), în timp ce pentru setările regionale americane (`en_US`), va fi afișată în dolari americani ($).

				
					<?php
$currency1 = NumberFormatter::create('it', NumberFormatter::CURRENCY);

$currency2 = NumberFormatter::create('en_US', NumberFormatter::CURRENCY);
				
			
Depășește barierele lingvistice
Spuneți adio barierelor lingvistice și salutați creșterea nelimitată! Încercați serviciul nostru de traducere automată astăzi.

Soluție alternativă Laravel localizare cu Linguise

O echipă lucrează împreună la un proiect digital. Sunt înconjurați de diverse instrumente și simboluri digitale.

După înțelegerea pașilor localizării Laravel așa cum este descrisă în articol, acest proces implică mulți pași care necesită ca utilizatorii să înțeleagă în profunzime codul programului Laravel .

Acest lucru poate îngreuna cu siguranță utilizatorii începători care doresc să localizeze aplicațiile lor. Prin urmare, este necesară o soluție mai inovatoare, capabilă de traducere rapidă, care să accepte localizarea și să necesite doar câțiva pași simpli pentru implementare.

O soluție promițătoare este Linguise. Linguise oferă o abordare mai simplă și mai eficientă pentru localizarea Laravel , fără a fi nevoie de cunoștințe aprofundate de programare. Caracteristicile cheie ale Linguise includ.

  • Integrare ușoară cu Laravel
  • Personalizează comutatorul de limbă fără cod
  • Traducere de imagini
  • Editor live pentru personalizarea traducerilor în funcție de contextul local
  • Traducere dinamică pentru conținut generat dinamic
  • Optimizare SEO pentru versiuni multilingve

Pașii pentru a instala Linguise pe site-urile Laravel pot fi, de asemenea, realizați cu ușurință. Iată o scurtă explicație.

  1. Creați un cont Linguise (folosiți versiunea de probă gratuită de 30 de zile)
  2. Înregistrați domeniul web Laravel și introduceți câteva informații. Veți primi o cheie API.
  3. Încarcă și conectează scriptul de traducere Linguise la folderul Laravel pe care l-ai obținut.
  4. Configurați adresele URL ale limbii în fișierul htaccess.
  5. Inserați scriptul comutatorului de limbă în secțiunea head a HTML-ului dvs.
  6. Personalizează comutatorul de limbă după cum este necesar
  7. Comutatorul de limbă va apărea pe site-ul web Laravel , iar conținutul poate fi tradus automat.

Cum? Cu Linguise, trebuie doar să te înregistrezi și să activezi, iar comutatorul de limbă va apărea. După aceea, ești liber să localizezi, de exemplu, prin editorul live, să traduci materiale media, imagini etc.

Ești gata să explorezi piețe noi? Încearcă serviciul nostru de traducere automată gratuit, cu o perioadă de probă de 1 lună fără riscuri. Nu este nevoie de card de credit!

Conclusion

Localizarea Laravel este o funcție puternică ce le permite dezvoltatorilor să creeze site-uri web și aplicații multilingve. După cum am văzut, procesul de localizare Laravel integrat implică mai mulți pași și necesită o bună înțelegere a framework-ului. Poate fi dificil pentru începători sau pentru cei care caută o soluție mai rapidă.

Instrumente precum Linguise oferă o alternativă inovatoare pentru cei care caută o abordare mai simplificată. Aceste soluții oferă capabilități rapide de traducere, integrare ușoară și funcții ușor de utilizat, cum ar fi comutatoare de limbă personalizabile și traducerea imaginilor. Acum, creează-ți contul Linguise și bucură-te de funcția noastră de localizare a Laravel!

S-ar putea să vă intereseze și lectura

Nu ratați!
Abonați-vă la newsletter-ul nostru

Primiți noutăți despre traducerea automată a site-urilor web, SEO internațional și multe altele!

Invalid email address
Încercați. Unul pe lună și vă puteți dezabona oricând.

Nu pleca fără să ne împărtășești adresa ta de email!

Nu îți putem garanta că vei câștiga la loterie, dar îți putem promite câteva știri informative interesante despre traducere și reduceri ocazionale.

Nu ratați!
Invalid email address