Stapsgewijze Laravel Lokalisatie [Gids]

Breng uw bedrijf naar een hoger niveau met wereldwijde expansie. Bedrijfsgroei en -ontwikkeling.
Table of Contents

Laravel -lokalisatie is een krachtige functie waarmee ontwikkelaars meertalige websites kunnen maken. Door weblokalisatie te implementeren in uw Laravel -projecten, kunt u een gepersonaliseerde gebruikerservaring bieden aan bezoekers met verschillende taalachtergronden, waardoor u uw bereik uiteindelijk vergroot en de betrokkenheid van gebruikers verbetert.

We leiden je door het implementeren van localisatie in je Laravel -applicatie en introduceren een tool die je localisatie-inspanningen kan vereenvoudigen en verbeteren!

Waarom zou u de Laravel -website lokaliseren?

Een man in een oranje hesje houdt een tablet vast met een wereldkaart. Verschillende landenvlaggen zijn te zien.

Hier zijn enkele belangrijke redenen waarom je je Laravel -website zou moeten lokaliseren.

  • Bereik een wereldwijd publiek: Door je Laravel -website te lokaliseren, kun je het bereik van je app uitbreiden naar een internationaal publiek. Hierdoor kunnen gebruikers uit verschillende landen en met verschillende taalachtergronden je content begrijpen en ermee interactie hebben.
  • Verbetert de gebruikerservaring: Lokalisatie stelt gebruikers in staat om met de app in hun moedertaal te werken, wat de gebruikerservaring aanzienlijk verbetert. Dit kan de betrokkenheid verhogen, het bouncepercentage verlagen en de conversies verhogen.
  • Concurrentievoordeel: In een concurrerende wereldmarkt kan het aanbieden van apps in meerdere talen een aanzienlijk voordeel opleveren ten opzichte van concurrenten. Het toont uw toewijding aan internationale markten en kan u helpen effectiever nieuwe markten te betreden.
  • Verbetert SEO: Goed gelokaliseerde websites scoren doorgaans beter in zoekmachines voor zoekopdrachten in een bepaalde taal. Dit kan je blogverkeer verhogen en de online zichtbaarheid in verschillende markten vergroten met meertalige vertaling.

Vereisten voor een meertalige Laravel -localisatie

Twee mensen werken samen op een groot computerscherm met verschillende apps. Ze lijken samen te werken.

Er zijn een paar vereisten en stappen waarmee u rekening moet houden bij het implementeren van meertalige lokalisatie in Laravel.

  • Zorg ervoor dat u de nieuwste versie van Laravel gebruikt (bijv. versie 10.x) om de nieuwste lokalisatiefuncties te krijgen.
  • Een basiskennis van PHP en het Laravel -framework is nuttig tijdens het implementatieproces.
  • Zet een lokale ontwikkelomgeving of server op die Laravelondersteunt, inclusief een webserver en database.
  • Bepaal vanaf het begin welke talen uw applicatie zal ondersteunen.

Eenvoudige Laravel -vertalingen

Man die op een laptop werkt. Webbrowsen op het scherm.

Nadat we hebben begrepen aan welke vereisten moet worden voldaan voordat een Laravel -applicatie of website wordt vertaald, geven we enkele stappen voor het eenvoudig vertalen van Laravel .

Om dit te doen, opent u het weergavebestand dat u wilt lokaliseren, bijvoorbeeld resources/views/welcome.blade.php. Vervang vervolgens de body-tag door de volgende code.

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

Zoals je kunt zien, staat de tekst hierboven momenteel rechtstreeks in de code. Dit is minder efficiënt en maakt het moeilijk om websites naar verschillende talen te vertalen (internationalisering). 

We gaan de bovenstaande tekst flexibeler maken, zodat deze eenvoudig kan worden aangepast aan verschillende talen. Laravel biedt hiervoor een zeer handige functie; het lokalisatiesysteem. Vervang als eerste stap de bestaande tekst door de volgende code.

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

Laravel geeft standaard de bovenstaande tekst weer en zoekt de vertaling op als de gebruiker een andere taal dan Engels selecteert. In dat geval wordt Engels gebruikt als de standaardtaal van de applicatie.

Locales instellen in een meertalige Laravel -website

Twee mensen werken op computerschermen. Ze werken met grote displays.

Maar hoe bepaalt Laravel de huidige taal of weet het welke talen beschikbaar zijn in de applicatie? Het controleert de locale-instellingen in het bestand config/app.php. Open dit bestand en zoek naar de volgende twee sleutels.

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

				
			

De uitleg boven de sleutels zou duidelijk moeten zijn. Samengevat: de locale-sleutel bevat de standaardtaal voor je applicatie (als er geen andere taal in de code is opgegeven). De fallback_locale wordt geactiveerd als er in je applicatie een niet-bestaande taal wordt opgevraagd.

Laten we nu een nieuwe sleutel aan dit bestand toevoegen om een lijst van alle ondersteunde locales te bieden.

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

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


				
			

Op dit punt hebben we Laravel web geprobeerd om drie talen te ondersteunen, namelijk Engels, Italiaans en Frans.

Overzicht van Laravel -vertaalbestanden

Een vrouw wijst naar een groot computerscherm met verschillende kleurrijke pictogrammen. Het scherm heeft een witte achtergrond met blauwe en paarse pictogrammen.

In Laravel, zoals in veel andere frameworks, worden vertalingen voor verschillende talen opgeslagen in afzonderlijke bestanden. Er worden twee methoden gebruikt om deze vertaalbestanden te organiseren.

De oudere methode slaat bestanden op in de volgende structuur: resources/lang/{en,fr,it}/{myfile.php}. De nieuwere methode gebruikt JSON-bestanden, zoals resources/lang/{fr.json, it.json}. Dit artikel richt zich op de nieuwere methode, hoewel de principes vergelijkbaar zijn voor de oudere methode, afgezien van verschillen in hoe vertaalsleutels worden benoemd en benaderd.

Voor talen met regionale variaties moet u de taal mappen of bestanden een naam geven volgens de ISO 15897-standaard. Brits Engels zou bijvoorbeeld en_GB worden genoemd in plaats van en-gb.

Algemene informatie

In Laravelworden, net als bij veel frameworks, vertalingen voor verschillende talen in afzonderlijke bestanden opgeslagen. Er zijn twee primaire methoden voor het organiseren van Laravel -vertaalbestanden.

  1. De legacy-aanpak houdt in dat bestanden worden opgeslagen onder het pad: resources/lang/{en,fr,it}/{myfile.php}.
  2. De moderne aanpak maakt gebruik van resources/lang/{fr.json, it.json}-bestanden.

Dit artikel richt zich op de tweede methode, hoewel de principes op beide van toepassing zijn (met variaties in de manier waarop vertaalsleutels worden benoemd en benaderd).

Voor talen die per regio verschillen, wordt aanbevolen om taal mappen/bestanden te benoemen volgens ISO 15897-normen. Brits Engels wordt bijvoorbeeld aangeduid als en_GB in plaats van en-gb.

Laravel -vertaalbestanden maken

Nu we de locales voor onze applicatie hebben geconfigureerd, kunnen we doorgaan met het vertalen van ons standaard welkomstbericht.

Laten we beginnen met het maken van nieuwe lokalisatiebestanden in JSON-formaat in de map resources/lang. Eerst maken we een bestand resources/lang/it.json en vullen dit met de juiste vertalingen.

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

				
			

Voeg vervolgens een bestand resources/lang/fr.json toe.

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

				
			

Zoals je kunt zien, verwijzen we consistent naar het standaardbericht uit het bestand welcome.blade.php ({{ __(‘Welkom op de website van Linguise !’) }}). Het is niet nodig om een en.json-bestand aan te maken, omdat Laravel automatisch herkent dat de standaardberichten in het Engels zijn.

Taalwisselaar instellen in een meertalige Laravel -app

Mensen die met een grote e-mailinterface werken.

Bovendien is Laravel nog niet ingesteld om de lokale taal te overschrijven, dus voorlopig zullen we de vertaling direct binnen de route afhandelen. Wijzig de standaard welkomstroute in het bestand routes/web.php als volgt.

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

In dit geval leggen we een optionele locale GET-parameter vast en stellen we de huidige locale daarop in (als de gevraagde locale wordt ondersteund).

Nu kunt u uw website bezoeken en een van de ondersteunde talen als eerste segment in de URL opnemen. Als u bijvoorbeeld naar localhost/it of localhost/fr navigeert, wordt de gelokaliseerde inhoud weergegeven. Als u geen locale opgeeft of een locale kiest die niet wordt ondersteund, gebruikt Laravel standaard Engels (en).

Localisatie-middleware voor Laravel

Het opnemen van de locale in elke URL is misschien niet ideaal en kan de visuele aantrekkingskracht van de site verstoren. Om dit op te lossen, stellen we een taalwisselaar in en gebruiken we de gebruikerssessie om de vertaalde inhoud weer te geven. Je kunt nieuwe middleware aanmaken in het bestand app/Http/Middleware/Localization.php, of deze genereren door het commando artisan make:middleware Localization uit te voeren.

Voeg vervolgens de volgende code toe.

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


				
			

Deze middleware zorgt ervoor dat Laravel de door de gebruiker geselecteerde locatie gebruikt, indien deze optie in de sessie aanwezig is.

Omdat we willen dat de bewerking bij elk verzoek wordt uitgevoerd, voeg je deze toe aan de standaard middleware-stack in app/Http/Kernel.php voor de web middleware-groep.

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


				
			

Routes aanpassen

Definieer vervolgens een route om de locale te wijzigen in het bestand routes/web.php. We gebruiken hier een closure-route, maar je kunt dezelfde code ook in een controller plaatsen als je dat liever hebt.

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

				
			

Verwijder daarnaast de taalwisseling die eerder is toegevoegd aan de standaard welkomstroute. Je rootroute zou er nu als volgt uit moeten zien.

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

				
			

Zodra dit is gedaan, kan de gebruiker de actieve taal alleen wijzigen door localhost/language/{locale} te bezoeken. De geselecteerde locale wordt opgeslagen in de sessie en gebruikers worden teruggeleid naar hun vorige pagina (zoals afgehandeld door de Localization-middleware). 

Om dit te testen, ga je naar localhost/language/it (ervan uitgaande dat de sessiecookie actief is in je browser), en je zou de vertaalde inhoud moeten zien. Je kunt door de site navigeren of de pagina vernieuwen, en de gekozen taal blijft van kracht.

Implementatie van taalschakelaar

Nu moeten we de gebruiker een klikbare optie bieden om de taalwisselaar Laravel web te wijzigen, in plaats van dat zij handmatig locale-codes in de URL moeten invoeren. Maak hiervoor een eenvoudige taalwisselaar. Voeg een nieuw bestand toe op resources/views/partials/language_switcher.blade.php en voeg de volgende code in.

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


				
			

Om de nieuw aangemaakte taalwisselaar op te nemen in de weergave “welcome”, voegt u eenvoudig de volgende regel toe aan uw welcome.blade.php-bestand op de plaats waar u de wisselaar wilt laten verschijnen.

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


				
			

Open het bestand app/Providers/AppServiceProvider.php en voeg de volgende code toe in de boot()-methode om de huidige locale te delen met alle views wanneer de taalwisselaar wordt gebruikt

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


				
			

Geavanceerde vertaalfuncties in Laravel PHP

Illustratie van mensen die aan een project werken. Een team dat samenwerkt.

In deze bespreking behandelen we vervolgens andere lokalisatiecomponenten, namelijk datum, getal en valuta. Dit zijn de stappen.

Gelokaliseerde datums in Laravel

Het verwerken van datums en tijden is cruciaal in het lokalisatieproces. Laravel gebruikt Carbon om datums en tijden te beheren. Hier is hoe je Carbon kunt gebruiken om een gelokaliseerde datum weer te geven.

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


				
			

Deze code stelt de Carbon-locale in op basis van de huidige locale van de applicatie en formatteert de datum dienovereenkomstig.

Om de gelokaliseerde datum in een weergave te tonen:

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


				
			

Getallen en valuta opmaken

Verschillende landen hanteren verschillende manieren om getallen te noteren. Bijvoorbeeld:.

  • Frankrijk → 123 123,12
  • Duitsland → 123.123,12
  • Japan → 123.123

Om deze variaties in je Laravel -applicatie op te vangen, kun je NumberFormatter gebruiken.

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

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

Je kunt getallen ook voluit schrijven in een specifieke taal.

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

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

Hier zijn de valuta's. Voor de Franse locale (`fr`) wordt de valuta weergegeven in euro's (€), terwijl deze voor de Amerikaanse locale (`en_US`) wordt weergegeven in Amerikaanse dollars ($).

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

$currency2 = NumberFormatter::create('en_US', NumberFormatter::CURRENCY);
				
			
Doorbreek taalbarrières
Zeg vaarwel tegen taalbarrières en hallo tegen onbeperkte groei! Probeer vandaag nog onze automatische vertaaldienst.

Alternatieve oplossing voor Laravel -localisatie met Linguise

Een team werkt samen aan een digitaal project. Ze zijn omringd door diverse digitale tools en symbolen.

Na het begrijpen van de stappen van Laravel -localisatie zoals beschreven in het artikel, omvat dit proces vele stappen die vereisen dat gebruikers de Laravel -programmacode grondig begrijpen.

Dit kan het zeker moeilijk maken voor beginnende gebruikers die hun applicaties willen lokaliseren. Daarom is een innovatievere oplossing nodig die snelle vertaling mogelijk maakt, lokalisatie ondersteunt en slechts een paar eenvoudige stappen vereist om te implementeren.

Een veelbelovende oplossing is Linguise. Linguise biedt een eenvoudigere en efficiëntere aanpak voor Laravel -localisatie zonder dat diepgaande programmeerkennis nodig is. Belangrijke kenmerken van Linguise zijn onder andere:.

  • Eenvoudige integratie met Laravel
  • Pas de taalwisselaar aan zonder codering
  • Beeldvertaling
  • Live-editor om vertalingen aan te passen aan de lokale context
  • Dynamische vertaling voor dynamisch gegenereerde content
  • SEO-optimalisatie voor meertalige versies

De stappen om Linguise op Laravel -websites te installeren kunnen ook eenvoudig worden uitgevoerd. Hier is een korte uitleg.

  1. Maak een Linguise -account aan (gebruik de gratis proefperiode van 30 dagen)
  2. Registreer je Laravel -webdomein en voer wat informatie in. Je ontvangt een API-sleutel.
  3. Upload het Linguise -vertaalscript en verbind het met de Laravel -map die je hebt ontvangen.
  4. Stel taal-URL's in het htaccess-bestand in.
  5. Voeg het script voor de taalwisselaar toe in de head van je HTML.
  6. Pas de taalschakelaar naar wens aan
  7. De taalwisselaar verschijnt op de Laravel -website en de inhoud kan automatisch worden vertaald.

Hoe? Met Linguisehoef je je alleen maar te registreren en te activeren, en de taalwisselaar verschijnt. Daarna ben je vrij om te lokaliseren, bijvoorbeeld via de live-editor, media te vertalen, afbeeldingen, enz.

Klaar om nieuwe markten te verkennen? Probeer onze automatische vertaaldienst gratis met onze 1 maand risicovrije proefperiode. Geen creditcard nodig!

Conclusie

Laravel -localisatie is een krachtige functie waarmee ontwikkelaars meertalige websites en applicaties kunnen maken. Zoals we hebben gezien, omvat het ingebouwde Laravel -localisatieproces meerdere stappen en vereist het een goed begrip van het framework. Het kan een uitdaging zijn voor beginners of voor wie een snellere oplossing zoekt.

Tools zoals Linguise bieden een innovatief alternatief voor wie een gestroomlijndere aanpak zoekt. Deze oplossingen bieden snelle vertaalmogelijkheden, eenvoudige integratie en gebruiksvriendelijke functies zoals aanpasbare taalwisselaars en beeldvertaling. Nu, maak je Linguise -account aan en profiteer van onze functie voor het lokaliseren van je Laravel!

Misschien vindt u het ook interessant om te lezen

Mis het niet!
Abonneer u op onze nieuwsbrief

Ontvang nieuws over automatische websitevertaling, internationale SEO en meer!

Invalid email address
Probeer het eens. Eén per maand, en u kunt zich op elk moment uitschrijven.

Vertrek niet zonder uw e-mailadres te delen!

We kunnen niet garanderen dat je de loterij wint, maar we beloven je wel interessante informatieve nieuwtjes over vertalingen en af en toe kortingen.

Mis het niet!
Invalid email address