Frontend - 2. Localization

Introduction

Die Lokalisierungsfunktionen von Laravel bieten eine bequeme Möglichkeit, Zeichenketten in verschiedenen Sprachen abzurufen, so dass Sie mehrere Sprachen innerhalb Ihrer Anwendung problemlos unterstützen können. Sprachzeichenketten werden in Dateien im Verzeichnis resources/lang gespeichert. In diesem Verzeichnis sollte es für jede von der Anwendung unterstützte Sprache ein Unterverzeichnis geben:

/resources
    /lang
        /en
            messages.php
        /es
            messages.php

Alle Sprachdateien geben ein Array von verschlüsselten Zeichenketten zurück. Zum Beispiel:

<?php

return [
    'welcome' => 'Welcome to our application'
];

Configuring The Locale

Die Standardsprache für Ihre Anwendung ist in der Konfigurationsdatei config/app.php gespeichert. Sie können diesen Wert an die Anforderungen Ihrer Anwendung anpassen. Sie können die aktive Sprache auch zur Laufzeit mit der setLocale Methode auf der App-Fassade ändern:

Route::get('welcome/{locale}', function ($locale) {
    App::setLocale($locale);

    //
});

Sie können eine "Fallback-Sprache" konfigurieren, die verwendet wird, wenn die aktive Sprache keine bestimmte Übersetzungszeichenfolge enthält. Wie die Standardsprache wird auch die Fallback-Sprache in der Konfigurationsdatei config/app.php konfiguriert:

'fallback_locale' => 'en',

Determining The Current Locale

Sie können die Methoden getLocale und isLocale auf der App-Fassade verwenden, um das aktuelle Gebietsschema zu bestimmen oder zu überprüfen, ob das Gebietsschema ein bestimmter Wert ist:

$locale = App::getLocale();

if (App::isLocale('en')) {
    //
}

more themes about Frontend [TaskID] - Click for open

Task

Type Table

Description

<h4>Using Short Keys</h4>

Normalerweise werden &Uuml;bersetzungszeichenketten in Dateien im Verzeichnis resources/lang gespeichert. In diesem Verzeichnis sollte es f&uuml;r jede von der Anwendung unterst&uuml;tzte Sprache ein Unterverzeichnis geben:

<pre>
<code>/resources
 /lang
 /en
 messages.php
 /es
 messages.php</code></pre>

Alle Sprachdateien geben ein Array von verschl&uuml;sselten Zeichenketten zur&uuml;ck. Zum Beispiel:

<pre>
<code>&lt;?php

// resources/lang/en/messages.php

return [
 &#39;welcome&#39; =&gt; &#39;Welcome to our application&#39;
];</code></pre>

<h4>Using Translation Strings As Keys</h4>

Bei Anwendungen mit hohem &Uuml;bersetzungsbedarf kann die Definition jeder Zeichenkette mit einem &quot;kurzen Schl&uuml;ssel&quot; schnell zu einer Konferenzschaltung f&uuml;hren, wenn Sie sie in Ihren Ansichten referenzieren. Aus diesem Grund bietet Laravel auch Unterst&uuml;tzung bei der Definition von &Uuml;bersetzungszeichenketten mit der &quot;Standard&uuml;bersetzung&quot; der Zeichenkette als Schl&uuml;ssel.

&Uuml;bersetzungsdateien, die &Uuml;bersetzungszeichenketten als Schl&uuml;ssel verwenden, werden als JSON-Dateien im Verzeichnis resources/lang gespeichert. Wenn Ihre Anwendung beispielsweise eine spanische &Uuml;bersetzung hat, sollten Sie eine Datei resources/lang/es.json erstellen:

<pre>
<code>{
 &quot;I love programming.&quot;: &quot;Me encanta programar.&quot;
}</code></pre>

Code

Task

Type Table

Description

<h4>Retrieving Translation Strings</h4>

Sie k&ouml;nnen Zeilen aus Sprachdateien mit der Hilfsfunktion __ abrufen. Die Methode __ akzeptiert die Datei und den Schl&uuml;ssel der &Uuml;bersetzungszeichenkette als erstes Argument. Lassen Sie uns zum Beispiel die welcome &Uuml;bersetzungszeichenfolge aus der Sprachdatei resources/lang/messages.php abrufen:

<pre>
<code>echo __(&#39;messages.welcome&#39;);

echo __(&#39;I love programming.&#39;);</code></pre>

Wenn Sie die <a href="https://laravel.creative-it.org/websites/60">Blade-Templates</a>&nbsp;verwenden, k&ouml;nnen Sie die Syntax {{&nbsp;&nbsp;}} verwenden, um die &Uuml;bersetzungszeichenfolge wiederzugeben, oder die @lang-Direktive verwenden:

<pre>
<code>{{ __(&#39;messages.welcome&#39;) }}

@lang(&#39;messages.welcome&#39;)</code></pre>

Wenn die angegebene &Uuml;bersetzungszeichenkette nicht existiert, gibt die Funktion __ den Schl&uuml;ssel der &Uuml;bersetzungszeichenkette zur&uuml;ck. In dem obigen Beispiel w&uuml;rde die Funktion __ also messages.welcome zur&uuml;ckgeben, wenn die &Uuml;bersetzungszeichenkette nicht existiert.

<div style="background:#eeeeee; border:1px solid #cccccc; padding:5px 10px">Die @lang-Direktive l&auml;sst keine Ausgabe aus. Sie sind voll verantwortlich daf&uuml;r, dass Sie bei der Verwendung dieser Richtlinie Ihrer eigenen Ausgabe verwenden.</div>

<h4>Replacing Parameters In Translation Strings</h4>

Wenn Sie m&ouml;chten, k&ouml;nnen Sie Platzhalter in Ihren &Uuml;bersetzungszeichenketten definieren. Alle Platzhalter werden mit einem vorangestellten :. Beispielsweise k&ouml;nnen Sie eine Begr&uuml;&szlig;ungsnachricht mit einem Platzhalternamen definieren:

<pre>
<code>&#39;welcome&#39; =&gt; &#39;Welcome, :name&#39;,</code></pre>

Um die Platzhalter beim Abrufen einer &Uuml;bersetzungszeichenkette zu ersetzen, &uuml;bergeben Sie der Funktion __ ein Array von Ersetzungen als zweites Argument:

<pre>
<code>echo __(&#39;messages.welcome&#39;, [&#39;name&#39; =&gt; &#39;dayle&#39;]);</code></pre>

Wenn Ihr Platzhalter alle Gro&szlig;buchstaben enth&auml;lt oder nur seinen ersten Buchstaben gro&szlig;geschrieben hat, wird der &uuml;bersetzte Wert entsprechend gro&szlig;geschrieben:

<pre>
<code>&#39;welcome&#39; =&gt; &#39;Welcome, :NAME&#39;, // Welcome, DAYLE
&#39;goodbye&#39; =&gt; &#39;Goodbye, :Name&#39;, // Goodbye, Dayle</code></pre>

<h4>Pluralization</h4>

Pluralisierung ist ein komplexes Problem, da verschiedene Sprachen eine Vielzahl von komplexen Pluralisierungsregeln haben. Durch die Verwendung eines &quot;pipe&quot;-Zeichens k&ouml;nnen Sie zwischen Singular- und Pluralformen einer Zeichenkette unterscheiden:

<pre>
<code>&#39;apples&#39; =&gt; &#39;There is one apple|There are many apples&#39;,</code></pre>

Sie k&ouml;nnen sogar komplexere Pluralisierungsregeln erstellen, die &Uuml;bersetzungszeichenketten f&uuml;r mehrere Nummernkreise festlegen:

<pre>
<code>&#39;apples&#39; =&gt; &#39;{0} There are none|[1,19] There are some|[20,*] There are many&#39;,</code></pre>

Nachdem Sie eine &Uuml;bersetzungszeichenfolge mit Pluralisierungsoptionen definiert haben, k&ouml;nnen Sie mit der Funktion trans_choice die Zeile f&uuml;r einen bestimmten &quot;count&quot; abrufen. In diesem Beispiel wird, da die Anzahl gr&ouml;&szlig;er als eins ist, die Pluralform der &Uuml;bersetzungszeichenkette zur&uuml;ckgegeben:

<pre>
<code>echo trans_choice(&#39;messages.apples&#39;, 10);</code></pre>

Sie k&ouml;nnen Platzhalterattribute auch in Pluralisierungszeichenketten definieren. Diese Platzhalter k&ouml;nnen durch die &Uuml;bergabe eines Arrays als drittes Argument an die trans_choice Funktion ersetzt werden:

<pre>
<code>&#39;minutes_ago&#39; =&gt; &#39;{1} :value minute ago|[2,*] :value minutes ago&#39;,

echo trans_choice(&#39;time.minutes_ago&#39;, 5, [&#39;value&#39; =&gt; 5]);</code></pre>

If you would like to display the integer value that was passed to the&nbsp;<code>trans_choice</code>&nbsp;function, you may use the&nbsp;<code>:count</code>&nbsp;placeholder:

<pre>
<code>&#39;apples&#39; =&gt; &#39;{0} There are none|{1} There is one|[2,*] There are :count&#39;,</code>
</pre>

Code

Retrieving Translation Strings

Sie können Zeilen aus Sprachdateien mit der Hilfsfunktion __ abrufen. Die Methode __ akzeptiert die Datei und den Schlüssel der Übersetzungszeichenkette als erstes Argument. Lassen Sie uns zum Beispiel die welcome Übersetzungszeichenfolge aus der Sprachdatei resources/lang/messages.php abrufen:

echo __('messages.welcome');

echo __('I love programming.');

Wenn Sie die Blade-Templates verwenden, können Sie die Syntax {{ }} verwenden, um die Übersetzungszeichenfolge wiederzugeben, oder die @lang-Direktive verwenden:

{{ __('messages.welcome') }}

@lang('messages.welcome')

Wenn die angegebene Übersetzungszeichenkette nicht existiert, gibt die Funktion __ den Schlüssel der Übersetzungszeichenkette zurück. In dem obigen Beispiel würde die Funktion __ also messages.welcome zurückgeben, wenn die Übersetzungszeichenkette nicht existiert.

Die @lang-Direktive lässt keine Ausgabe aus. Sie sind voll verantwortlich dafür, dass Sie bei der Verwendung dieser Richtlinie Ihrer eigenen Ausgabe verwenden.

Replacing Parameters In Translation Strings

Wenn Sie möchten, können Sie Platzhalter in Ihren Übersetzungszeichenketten definieren. Alle Platzhalter werden mit einem vorangestellten :. Beispielsweise können Sie eine Begrüßungsnachricht mit einem Platzhalternamen definieren:

'welcome' => 'Welcome, :name',

Um die Platzhalter beim Abrufen einer Übersetzungszeichenkette zu ersetzen, übergeben Sie der Funktion __ ein Array von Ersetzungen als zweites Argument:

echo __('messages.welcome', ['name' => 'dayle']);

Wenn Ihr Platzhalter alle Großbuchstaben enthält oder nur seinen ersten Buchstaben großgeschrieben hat, wird der übersetzte Wert entsprechend großgeschrieben:

'welcome' => 'Welcome, :NAME', // Welcome, DAYLE
'goodbye' => 'Goodbye, :Name', // Goodbye, Dayle

Pluralization

Pluralisierung ist ein komplexes Problem, da verschiedene Sprachen eine Vielzahl von komplexen Pluralisierungsregeln haben. Durch die Verwendung eines "pipe"-Zeichens können Sie zwischen Singular- und Pluralformen einer Zeichenkette unterscheiden:

'apples' => 'There is one apple|There are many apples',

Sie können sogar komplexere Pluralisierungsregeln erstellen, die Übersetzungszeichenketten für mehrere Nummernkreise festlegen:

'apples' => '{0} There are none|[1,19] There are some|[20,*] There are many',

Nachdem Sie eine Übersetzungszeichenfolge mit Pluralisierungsoptionen definiert haben, können Sie mit der Funktion trans_choice die Zeile für einen bestimmten "count" abrufen. In diesem Beispiel wird, da die Anzahl größer als eins ist, die Pluralform der Übersetzungszeichenkette zurückgegeben:

echo trans_choice('messages.apples', 10);

Sie können Platzhalterattribute auch in Pluralisierungszeichenketten definieren. Diese Platzhalter können durch die Übergabe eines Arrays als drittes Argument an die trans_choice Funktion ersetzt werden:

'minutes_ago' => '{1} :value minute ago|[2,*] :value minutes ago',

echo trans_choice('time.minutes_ago', 5, ['value' => 5]);

If you would like to display the integer value that was passed to the trans_choice function, you may use the :count placeholder:

'apples' => '{0} There are none|{1} There is one|[2,*] There are :count',

Task

Type Table

Description

<h4>Overriding Package Language Files</h4>

Einige Pakete k&ouml;nnen mit ihren eigenen Sprachdateien ausgeliefert werden. Anstatt die Kerndateien des Pakets zu &auml;ndern, um diese Zeilen zu optimieren, k&ouml;nnen Sie sie &uuml;berschreiben, indem Sie Dateien in das Verzeichnis resources/lang/vendor/package}/{locale} legen.

Wenn Sie also z.B. die englischen &Uuml;bersetzungszeichenketten in messages.php f&uuml;r ein Paket namens skyrim/hearthfire &uuml;berschreiben m&uuml;ssen, sollten Sie eine Sprachdatei platzieren unter: resources/lang/vendor/hearthfire/en/messages.php. In dieser Datei sollten Sie nur die &Uuml;bersetzungszeichenketten definieren, die Sie &uuml;berschreiben m&ouml;chten. Alle &Uuml;bersetzungszeichenketten, die Sie nicht &uuml;berschreiben, werden weiterhin aus den Originalsprachdateien des Pakets geladen.

Code