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 ?

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

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

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.
Welcome to Linguise website!
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

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

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 .
- Tradycyjne podejście polega na przechowywaniu plików w ścieżce: resources/lang/{en,fr,it}/{myfile.php}.
- 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

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.
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>
*/
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.
@foreach($available_locales as $locale_name => $available_locale)
@if($available_locale === $current_locale)
{{ $locale_name }}
@else
{{ $locale_name }}
@endif
@endforeach
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.
@include('partials/language_switcher')
{{ __('Welcome to our website!') }}
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

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ę.
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’]) }}
{{ trans_choice('{0} There :form :count apples|{1} There :form just :count apple|[2,19] There :form :count apples', 1, ['form' => 'is']) }}
{{ $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.
Możesz także zapisywać liczby słownie w określonym języku.
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 ($).
Alternatywne rozwiązanie Laravel localization z Linguise

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.
- Utwórz konto Linguise (skorzystaj z 30-dniowego bezpłatnego okresu próbnego)
- Zarejestruj swoją domenę internetową Laravel i wprowadź kilka informacji. Otrzymasz klucz API.
- Wgraj i podłącz skrypt tłumaczeniowy Linguise do folderu Laravel , który otrzymałeś.
- Skonfiguruj adresy URL języków w pliku htaccess.
- Wstaw skrypt przełącznika języka w sekcji head swojego kodu HTML.
- Dostosuj przełącznik języka według potrzeb
- 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.
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!



