Lokalizacja Laravel krok po kroku [Przewodnik]

Wynieś swój biznes na wyższy poziom dzięki globalnej ekspansji. Wzrost i rozwój biznesu.
Spis treści

Laravel to potężne narzędzie, które umożliwia programistom tworzenie wielojęzycznych stron internetowych. Dzięki wdrożeniu lokalizacji strony internetowej w Twoich projektach Laravel możesz zapewnić spersonalizowane doświadczenie użytkownika dla odwiedzających z różnych środowisk językowych, co ostatecznie rozszerza Twój zasięg i poprawia zaangażowanie użytkowników.

Przeprowadzimy Cię przez proces wdrażania lokalizacji w Twojej aplikacji Laravel i przedstawimy narzędzie, które może uprościć i usprawnić Twoje działania związane z lokalizacją!

Dlaczego warto zlokalizować witrynę Laravel ?

Mężczyzna w pomarańczowej kamizelce trzymający tablet z mapą świata. Widoczne są flagi różnych krajów.

Oto kilka ważnych powodów, dla których warto zlokalizować swoją witrynę Laravel .

  • Dotrzyj do globalnej publiczności: Lokalizując swoją stronę Laravel , możesz rozszerzyć zasięg swojej aplikacji na międzynarodową publiczność. Pozwala to użytkownikom z różnych krajów i środowisk językowych zrozumieć Twoje treści i wchodzić z nimi w interakcję.
  • Poprawia doświadczenie użytkownika: Lokalizacja pozwala użytkownikom korzystać z aplikacji w ich ojczystym języku, co znacząco poprawia doświadczenie użytkownika. Może to zwiększyć wskaźniki zaangażowania, zmniejszyć współczynnik odrzuceń i zwiększyć konwersje.
  • Przewaga konkurencyjna: Na konkurencyjnym globalnym rynku oferowanie aplikacji w wielu językach może zapewnić znaczącą przewagę nad konkurentami. Pokazuje to Twoje zaangażowanie w rynki międzynarodowe i może pomóc skuteczniej wejść na nowe rynki.
  • Poprawia SEO: Dobrze zlokalizowane strony internetowe mają tendencję do lepszego pozycjonowania w wyszukiwarkach dla zapytań w danym języku. Może to zwiększyć ruch na Twoim blogu i widoczność online na różnych rynkach dzięki tłumaczeniu wielojęzycznemu.

Wymagania dotyczące wielojęzycznej lokalizacji Laravel

Dwie osoby współpracujące przy dużym ekranie komputera z różnymi aplikacjami. Wygląda na to, że pracują razem.

Istnieje kilka wymagań i kroków do rozważenia podczas wdrażania wielojęzycznej lokalizacji w Laravel.

  • Aby uzyskać najnowsze funkcje lokalizacji, upewnij się, że używasz najnowszej wersji Laravel (np. wersji 10.x).
  • Podstawowa znajomość PHP i frameworka Laravel będzie pomocna w procesie wdrażania.
  • Skonfiguruj lokalne środowisko programistyczne lub serwer obsługujący Laravel, w tym serwer WWW i bazę danych.
  • Określ języki, które Twoja aplikacja będzie obsługiwać od samego początku.

Proste tłumaczenia Laravel

Mężczyzna pracuje na laptopie. Przeglądanie stron internetowych na ekranie.

Po zrozumieniu, jakie wymagania muszą być spełnione przed tłumaczeniem aplikacji Laravel lub strony internetowej, przedstawimy kilka kroków do prostego tłumaczenia Laravel .

Aby to zrobić, otwórz plik widoku, który chcesz zlokalizować, na przykład resources/views/welcome.blade.php. Następnie zastąp znacznik body poniższym kodem.

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

Jak widać, powyższy tekst jest obecnie zapisany bezpośrednio w kodzie. Jest to mniej wydajne i utrudnia tłumaczenie stron internetowych na różne języki (internacjonalizację). 

Sprawimy, że powyższy tekst będzie bardziej elastyczny, aby można go było łatwo dostosować do różnych języków. Laravel zapewnia do tego bardzo przydatną funkcję; system lokalizacji. W pierwszym kroku zastąp istniejący tekst następującym kodem.

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

Laravel domyślnie wyświetli powyższy tekst i wyszuka tłumaczenie, jeśli użytkownik wybierze język inny niż angielski. W tym przypadku angielski będzie używany jako domyślny język aplikacji.

Konfigurowanie ustawień regionalnych w wielojęzycznej witrynie Laravel

Dwie osoby pracujące przy ekranach komputerów. Wchodzą w interakcję z dużymi wyświetlaczami.

Ale w jaki sposób Laravel określa bieżący język lub wie, jakie języki są dostępne w aplikacji? Sprawdza ustawienia regionalne w pliku config/app.php. Otwórz ten plik i poszukaj dwóch poniższych kluczy.

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

				
			

Wyjaśnienie powyżej kluczy powinno być jasne. Podsumowując, klucz locale przechowuje domyślne ustawienia regionalne dla Twojej aplikacji (jeśli w kodzie nie określono innych ustawień regionalnych). Parametr fallback_locale jest aktywowany, gdy w aplikacji zostanie zażądane ustawienie regionalne, które nie istnieje.

Teraz dodajmy nowy klucz do tego pliku, aby udostępnić listę wszystkich obsługiwanych ustawień regionalnych.

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

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


				
			

W tym momencie wypróbowaliśmy Laravel web do obsługi trzech języków, a mianowicie angielskiego, włoskiego i francuskiego.

Przegląd plików tłumaczeń Laravel

Kobieta wskazuje na duży ekran komputera wyświetlający kolorowe ikony. Ekran ma białe tło z niebieskimi i fioletowymi ikonami.

W Laravel, podobnie jak w wielu innych frameworkach, tłumaczenia dla różnych języków są przechowywane w oddzielnych plikach. Do organizacji tych plików tłumaczeń stosuje się dwie metody.

Starsza metoda przechowuje pliki w następującej strukturze: resources/lang/{en,fr,it}/{myfile.php}. Nowsza metoda wykorzystuje pliki JSON, takie jak resources/lang/{fr.json, it.json}. Ten artykuł skupi się na nowszej metodzie, choć zasady są podobne w przypadku starszej metody, poza różnicami w sposobie nazywania i dostępu do kluczy tłumaczeń.

W przypadku języków z odmianami regionalnymi katalogi lub pliki językowe należy nazywać zgodnie z normą ISO 15897. Na przykład brytyjski angielski powinien być nazwany en_GB, a nie en-gb.

Informacje ogólne

W Laravel, podobnie jak w wielu frameworkach, tłumaczenia na różne języki są przechowywane w oddzielnych plikach. Istnieją dwie główne metody organizowania plików tłumaczeń Laravel .

  1. Tradycyjne podejście polega na przechowywaniu plików w ścieżce: resources/lang/{en,fr,it}/{myfile.php}.
  2. Nowoczesne podejście wykorzystuje pliki resources/lang/{fr.json, it.json}.

Ten artykuł skupi się na drugiej metodzie, choć zasady mają zastosowanie do obu (z różnicami w sposobie nazywania i uzyskiwania dostępu do kluczy tłumaczeń).

W przypadku języków, które różnią się w zależności od regionu, zaleca się nazywanie katalogów/plików językowych zgodnie z normą ISO 15897. Na przykład brytyjski angielski byłby oznaczony jako en_GB, a nie en-gb.

Tworzenie plików tłumaczeń Laravel

Po skonfigurowaniu ustawień regionalnych dla naszej aplikacji możemy przetłumaczyć domyślną wiadomość powitalną.

Zacznijmy od utworzenia nowych plików lokalizacyjnych w formacie JSON w katalogu resources/lang. Najpierw utworzymy plik resources/lang/it.json i wypełnimy go odpowiednimi tłumaczeniami.

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

				
			

Następnie dodaj plik resources/lang/fr.json.

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

				
			

Jak można zauważyć, konsekwentnie odwołujemy się do domyślnej wiadomości z pliku welcome.blade.php ({{ __(‘Welcome to Linguise website!’) }}). Nie ma potrzeby tworzenia pliku en.json, ponieważ Laravel automatycznie rozpoznaje, że domyślne wiadomości są w języku angielskim.

Ustawianie przełącznika języków w aplikacji wielojęzycznej Laravel

Osoby korzystające z dużego interfejsu e-mail.

Co więcej, Laravel nie jest jeszcze skonfigurowany do nadpisywania lokalnego języka, więc na razie zajmiemy się tłumaczeniem bezpośrednio w ramach trasy. Zmodyfikuj domyślną trasę powitalną w pliku routes/web.php w następujący sposób.

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

W tym przypadku przechwytujemy opcjonalny parametr GET locale i ustawiamy na jego podstawie bieżące ustawienia regionalne (jeśli żądane ustawienia regionalne są obsługiwane).

Teraz możesz odwiedzić swoją stronę internetową i umieścić dowolny z obsługiwanych języków jako pierwszy segment adresu URL. Na przykład przejście do localhost/it lub localhost/fr wyświetli zlokalizowaną treść. Jeśli nie określisz ustawień regionalnych lub wybierzesz nieobsługiwane, Laravel domyślnie ustawi język angielski (en).

Middleware lokalizacji dla Laravel

Umieszczanie ustawień regionalnych w każdym adresie URL może nie być idealne i może zakłócać atrakcyjność wizualną witryny. Aby temu zaradzić, skonfigurujemy przełącznik języka i wykorzystamy sesję użytkownika do wyświetlania przetłumaczonej treści. Możesz utworzyć nowy middleware w pliku app/Http/Middleware/Localization.php lub wygenerować go, uruchamiając polecenie artisan make:middleware Localization.

Następnie dodaj poniższy kod do środka.

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


				
			

To oprogramowanie pośredniczące nakieruje Laravel na użycie lokalizacji wybranej przez użytkownika, jeśli ta opcja jest obecna w sesji.

Ponieważ potrzebujemy, aby operacja była wykonywana przy każdym żądaniu, dodaj ją do domyślnego stosu middleware w app/Http/Kernel.php dla grupy 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
],


				
			

Modyfikowanie tras

Następnie zdefiniuj trasę do zmiany ustawień regionalnych w pliku routes/web.php. Używamy tutaj trasy typu closure, ale jeśli wolisz, możesz umieścić ten sam kod wewnątrz kontrolera.

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

				
			

Dodatkowo usuń przełączanie języka, które zostało wcześniej dodane do domyślnej trasy powitalnej. Twoja trasa główna powinna teraz wyglądać tak.

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

				
			

Gdy to zostanie zrobione, użytkownik może zmienić aktywny język wyłącznie, odwiedzając localhost/language/{locale}. Wybrany locale zostanie zapisany w sesji, a użytkownicy zostaną przekierowani z powrotem na poprzednią stronę (co jest obsługiwane przez middleware lokalizacji). 

Aby to przetestować, przejdź do localhost/language/it (zakładając, że w przeglądarce jest aktywny plik cookie sesji), a powinieneś zobaczyć przetłumaczoną treść. Możesz nawigować po witrynie lub odświeżyć stronę, a wybrany język pozostanie aktywny.

Implementacja przełącznika języków

Teraz musimy zapewnić użytkownikowi klikalną opcję zmiany przełącznika języków Laravel web zamiast wymagać od niego ręcznego wpisywania kodów językowych w adresie URL. Aby to osiągnąć, utwórz prosty przełącznik języków. Dodaj nowy plik w resources/views/partials/language_switcher.blade.php i wstaw następujący kod.

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


				
			

Aby dodać nowo utworzony przełącznik języka do widoku „welcome”, wystarczy dodać następujący wiersz do pliku welcome.blade.php w miejscu, w którym ma się pojawić przełącznik.

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


				
			

Otwórz plik app/Providers/AppServiceProvider.php i dodaj następujący kod w metodzie boot(), aby udostępnić bieżące ustawienia regionalne wszystkim widokom, gdy używany jest przełącznik języka

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


				
			

Zaawansowane funkcje tłumaczeń w Laravel PHP

Ilustracja przedstawiająca ludzi pracujących nad projektem. Zespół współpracujący.

W tej części zajmiemy się następnie innymi elementami lokalizacji, a mianowicie datą, liczbami i walutą. Oto kroki.

Lokalizowane daty w Laravel

Obsługa dat i godzin jest kluczowa w procesie lokalizacji. Laravel używa Carbon do zarządzania datami i godzinami. Oto jak możesz użyć Carbon, aby wyświetlić zlokalizowaną datę.

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


				
			

Ten kod ustawia ustawienia regionalne Carbon na podstawie bieżących ustawień regionalnych aplikacji i odpowiednio formatuje datę.

Aby wyświetlić zlokalizowaną datę w widoku:

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


				
			

Formatowanie liczb i walut

W różnych krajach obowiązują różne sposoby formatowania liczb. Na przykład:.

  • Francja → 123 123,12
  • Niemcy → 123.123,12
  • Japonia → 123 123

Aby uwzględnić te różnice w Twojej aplikacji Laravel , możesz użyć NumberFormatter.

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

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

Możesz także zapisywać liczby słownie w określonym języku.

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

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

Oto waluty. Dla ustawień regionalnych francuskich (`fr`) waluta będzie wyświetlana w euro (€), natomiast dla ustawień regionalnych amerykańskich (`en_US`) będzie wyświetlana w dolarach amerykańskich ($).

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

$currency2 = NumberFormatter::create('en_US', NumberFormatter::CURRENCY);
				
			
Break Language Barriers
Pożegnaj bariery językowe i przywitaj nieograniczony wzrost! Wypróbuj naszą usługę automatycznego tłumaczenia już dziś.

Alternatywne rozwiązanie Laravel localization z Linguise

Zespół pracujący wspólnie nad projektem cyfrowym. Otaczają ich różnorodne narzędzia i symbole cyfrowe.

Po zrozumieniu kroków lokalizacji Laravel opisanych w artykule, proces ten obejmuje wiele etapów, które wymagają od użytkowników dogłębnego zrozumienia kodu programu Laravel .

Może to z pewnością sprawić trudność początkującym użytkownikom, którzy chcą zlokalizować swoje aplikacje. Dlatego potrzebne jest bardziej innowacyjne rozwiązanie, które umożliwia szybkie tłumaczenie, obsługuje lokalizację i wymaga jedynie kilku prostych kroków do wdrożenia.

Jednym z obiecujących rozwiązań jest Linguise. Linguise oferuje łatwiejsze i wydajniejsze podejście do lokalizacji Laravel bez konieczności posiadania dogłębnej wiedzy programistycznej. Kluczowe funkcje Linguise obejmują.

  • Łatwa integracja z Laravel
  • Dostosuj przełącznik języka bez kodowania
  • Tłumaczenie obrazu
  • Edytor na żywo umożliwiający dostosowywanie tłumaczeń do lokalnego kontekstu
  • Dynamiczne tłumaczenie dla treści generowanych dynamicznie
  • Optymalizacja SEO dla wersji wielojęzycznych

Kroki, aby zainstalować Linguise na stronach Laravel również można wykonać łatwo. Oto krótkie wyjaśnienie.

  1. Utwórz konto Linguise (skorzystaj z 30-dniowego bezpłatnego okresu próbnego)
  2. Zarejestruj swoją domenę internetową Laravel i wprowadź kilka informacji. Otrzymasz klucz API.
  3. Wgraj i podłącz skrypt tłumaczeniowy Linguise do folderu Laravel , który otrzymałeś.
  4. Skonfiguruj adresy URL języków w pliku htaccess.
  5. Wstaw skrypt przełącznika języka w sekcji head swojego kodu HTML.
  6. Dostosuj przełącznik języka według potrzeb
  7. Przełącznik języka pojawi się w witrynie Laravel , a treść będzie mogła być tłumaczona automatycznie.

Jak? Dzięki Linguisewystarczy się zarejestrować i aktywować, a przełącznik języka pojawi się automatycznie. Następnie możesz swobodnie lokalizować, na przykład za pomocą edytora na żywo, tłumaczyć multimedia, obrazy itp.

Gotowy na odkrywanie nowych rynków? Wypróbuj naszą usługę automatycznego tłumaczenia za darmo w ramach 1-miesięcznego okresu próbnego bez ryzyka. Karta kredytowa nie jest wymagana!

Podsumowanie

Lokalizacja Laravel to potężna funkcja, która umożliwia programistom tworzenie wielojęzycznych stron internetowych i aplikacji. Jak widzieliśmy, wbudowany proces lokalizacji Laravel obejmuje wiele kroków i wymaga dobrej znajomości frameworka. Może być trudny dla początkujących lub tych, którzy szukają szybszego rozwiązania.

Narzędzia takie jak Linguise oferują innowacyjną alternatywę dla tych, którzy szukają prostszego podejścia. Te rozwiązania zapewniają szybkie tłumaczenie, łatwą integrację oraz przyjazne dla użytkownika funkcje, takie jak konfigurowalne przełączniki języka i tłumaczenie obrazów. Teraz utwórz swoje konto Linguise i korzystaj z naszej funkcji lokalizacji swojego Laravel!

Może Cię również zainteresować lektura

Nie przegap tego!
Subscribe to our Newsletter

Otrzymuj wiadomości o automatycznym tłumaczeniu stron internetowych, międzynarodowym SEO i nie tylko!

Invalid email address
Wypróbuj. Raz w miesiącu, a w każdej chwili możesz zrezygnować z subskrypcji.

Nie wychodź bez podania swojego adresu e-mail!

Nie możemy zagwarantować, że wygrasz na loterii, ale możemy obiecać ciekawe informacje na temat tłumaczeń i okazjonalne rabaty.

Nie przegap tego!
Invalid email address