Wie man eine Laravel -Anwendung internationalisiert

Sprachdateien erstellen: Erstellen Sie Subdirektorien für jede Sprache (z. B. en, es) im Ressourcen-/Lang -Verzeichnis und fügen Sie Message.php -Datei hinzu, oder verwenden Sie die JSON -Datei, um die Übersetzung zu speichern. 2. Setzen Sie die Anwendungssprache: Lesen Sie den Anforderungsheader Akzeptieren Sie die Sprache über Middleware oder erkennen Sie die Sprache über das URL-Präfix, setzen Sie die aktuelle Sprache mit app ()-> setlocale () und registrieren Sie die Middleware in kernel.php. 3.. Verwenden Sie Übersetzungsfunktionen: Verwenden Sie __ (), trans () oder @lang in der Ansicht, um den Übersetzungsinhalt zu erhalten, und es wird empfohlen, __ () zu verwenden, der Fallback unterstützt. 4. Supportparameter und Plural: Verwenden Sie Platzhalter wie: Name in Übersetzungszeichenfolgen und verwenden Sie trans_choice (), um Pluralformen wie '{0} NO -Äpfel | {1} Ein Apfel | [2,*]: Zählen von Äpfeln'; 5. Konfigurieren Sie die Fallback -Sprache: Setzen Sie Locale und Fallback_locale in config/app.php, um die Standardsprache zu gewährleisten, wenn die Übersetzung fehlt. 6. Optionale Leistungsoptimierung: Die Produktionsumgebung kann Übersetzungscache durch Drittanbieter-Pakete realisieren. 7. Front-End-Integration: Übersetzung über die API-Schnittstelle aussetzen oder rahmenspezifische Plug-Ins verwenden, um Sprachpakete zu teilen. Zusammenfassung: Laravel Internationalization erfordert eine strukturierte Verwaltung von Sprachdateien, die einheitliche Verwendung von __ () -Funktion, setzt die Sprache dynamisch mit Middleware und handelt Parameter, Pluralen und Fallbacks, um mehrsprachige Unterstützung zu erzielen.

Mit der Internationalisierung einer Laravel -Anwendung können Sie Inhalte in mehreren Sprachen bedienen und Ihre App für ein globales Publikum zugänglich machen. Laravel bietet eine solide integrierte Unterstützung für die Lokalisierung durch Sprachdateien und Helferfunktionen. Hier erfahren Sie, wie Sie es richtig einrichten können.

1. Setzen Sie Sprachdateien ein

Laravel speichert Sprachzeichenfolgen in resources/lang -Verzeichnis. Jede Sprache hat ein eigenes Unterverzeichnis (z. B. en , es , fr ).

Erstellen Sie Sprachverzeichnisse und Dateien:

 /Ressourcen
  /lang
    /en
      messus.php
    /es
      messus.php

Beispiel: /resources/lang/en/messages.php

 <? Php

Zurückkehren [
    &#39;Willkommen&#39; => &#39;Willkommen zu unserer Bewerbung&#39;, &#39;
    &#39;Login&#39; => &#39;Login&#39;,
];

Beispiel: /resources/lang/es/messages.php

 <? Php

Zurückkehren [
    &#39;Willkommen&#39; => &#39;Bienvenido A Nuestra Aplicación&#39;,
    &#39;Login&#39; => &#39;Iniciar sesión&#39;,
];

Sie können auch JSON -Dateien für einzelne Übersetzungszeichenfolgen (z. B. resources/lang/es.json ) verwenden, die Laravel nativ unterstützt.

2. Erkennen und setzen Sie das Anwendungsgebietsschema

Laravel verwendet die App::setLocale() -Methode, um die Sprachen zu wechseln. Sie müssen die bevorzugte Sprache des Benutzers bestimmen und früh im Anforderungslebenszyklus festlegen.

Option A: Middleware (empfohlen)

Erstellen Sie eine Middleware, um das Gebietsschema festzulegen:

 Php Artisan Make: Middleware Setlocale

In app/Http/Middleware/SetLocale.php :

 öffentliche Funktion Handle ($ Anfrage, \ Clospeure $ Nächst)
{
    $ locale = $ request-> header ('Akzeptierende Sprache', 'en');

    // Gebietsschema validieren und sanieren (z. B. 'en', 'es')
    $ unterstützteedLocales = ['en', 'es', 'fr'];
    if (! in_array ($ locale, $ unterstützteedLocales)) {
        $ locale = 'en'; // zurückgreifen
    }

    app ()-> setLocale ($ locale);

    Rückgabe $ als nächstes ($ request);
}

Registrieren Sie die Middleware unter $middleware oder einer Routengruppe in app/Http/Kernel.php .

Option B: URL-basiertes Gebietsschema

Sie können das Gebietsschema auch über die URL übergeben:

 Route :: Get ('/{Locale}/Welcome', Funktion ($ Locale) {
    app ()-> setLocale ($ locale);
    Rückkehransicht ('Willkommen');
});

Oder verwenden Sie eine Routengruppe:

 Route :: Prefix ('{Locale}')-> Middleware ('set.locale')-> Group (function () {
    Route :: GET ('/Welcome', [WelcomEcontroller :: class, 'index']);
});

Extrahieren und speichern Sie das Gebietsschema in den Sitzungs- oder Benutzereinstellungen.

3.. Verwenden Sie Übersetzungsfunktionen in Ansichten und Code

Laravel bietet mehrere Helfer, um übersetzte Saiten abzurufen.

Verwenden Sie __() Helfer:

 <h1> {{__ (&#39;messus.welcome&#39;)}} </h1>
<p> {{__ (&#39;messus.login&#39;)}} </p>

Oder mit JSON -Übersetzungen:

 <h1> {{__ (&#39;Willkommen zu unserer Anwendung&#39;)}} </h1>

Verwenden Sie @lang Blade -Richtlinie:

 @lang ('messus.welcome')

Hinweis: @lang fällt nicht auf andere Sprachen zurück und ist weniger flexibel als __() , also wird __() bevorzugt.

Übergeben von Parametern

Für dynamische Übersetzungen:

 // Sprachdatei
'Hallo' => 'Hallo,: Name',

 {{__ ('messages.hello', ['name' => 'John'])}}

4. Pluralisierung und Auswahl

Laravel unterstützt die Pluralisation unter Verwendung der Funktion trans_choice() .

Beispiel in Sprachdatei:

 'apples' => '{0} Keine Äpfel | {1} Ein Apfel | [2,*]: Zählen Sie Äpfel',,

Oder Verwenden von Platzhaltern:

 'apples' => 'ein Apple |: Zählen von Äpfeln',

Verwendung:

 {{trans_choice ('messages.apples', 3)}}

Dies gibt aus: 3 apples .

5. Fallback und fehlende Übersetzungen

Laravel fällt zurück in das Standard -Gebietsschema (definiert in config/app.php ), wenn eine Übersetzung fehlt.

Stellen Sie sicher, dass Ihre config/app.php enthält:

 'Locale' => 'en',
'Fallback_locale' => 'en',

Sie können fehlende Übersetzungen protokollieren oder verarbeiten, indem Sie den Übersetzer von Laravel erweitern, aber standardmäßig wird der Schlüssel oder Fallback zurückgegeben.

6. Caching -Übersetzungen (optional)

In der Produktion können Sie Sprachdateien für die Leistung zwischenspeichern:

 PHP Artisan Config: Cache
PHP Artisan Route: Cache

Während Laravel nicht standardmäßig lang:cache bietet, können Sie Pakete wie barryvdh/laravel-translation-manager verwenden oder bei Bedarf eine benutzerdefinierte Cache-Ebene implementieren.

7. JavaScript -Integration (optional)

Wenn Ihre Frontend-Übersetzungen benötigt, sollten Sie Pakete wie spatie/laravel-translatable oder inertiajs/inertia mit gemeinsam genutzten Requisiten verwenden oder Übersetzungen über einen sicheren Endpunkt aufdecken:

 Route :: get ('/translations/{Locale}', Funktion ($ Locale) {
    $ translations = Translate ('Nachrichten', [], $ Locale);
    return response ()-> json ($ translations);
});

Oder verwenden Sie ein Paket wie vue-i18n / laravel-vue-i18n wenn Sie VUE verwenden.

Zusammenfassung

Um eine Laravel -App zu internationalisieren:

• Übersetzungen in resources/lang/{locale}/ speichern
• Verwenden Sie __() oder trans() Helfer in Ansichten und Controllern
• Erkennen Sie die Sprache über Header-, URL- oder Benutzereinstellungen
• Stellen Sie den Gebietsschema mit Middleware ein
• Unterstützungsparameter und Pluralisierung
• Gehen Sie Fallbacks und fehlende Schlüssel um

Es ist nicht komplex, aber die Konsistenz in der Struktur und der Planung Ihrer Gebiete im Voraus erleichtert die Wartung.

Das obige ist der detaillierte Inhalt vonWie man eine Laravel -Anwendung internationalisiert. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!