Wie die Erstellung von mehrsprachigen übersetzt Routen in Laravel

Was Marcin Nabiałek uns mit in seine erste Antwort ist eine solide Lösung, um die Strecke das problem der Lokalisierung.

Der Kleine Popanz:

Der einzige wirkliche Nachteil mit seiner Lösung ist, dass wir nicht gecachten Routen, das kann manchmal von großem Vorteil, da pro Laravel's docs:

Wenn Ihre Anwendung ausschließlich unter Verwendung der controller-basierten Routen, die Sie
nehmen sollte Vorteil von Laravel route-cache. Mit den route-cache
drastisch verringern die Menge der Zeit, die es braucht, um sich registrieren alle
Ihre Anwendung Strecken. In einigen Fällen, Ihre route Registrierung
kann sogar bis zu 100x schneller. Zum generieren einer route-cache führen
die route:cache Handwerker-Befehl.

---

Warum können wir nicht cache-Routen?

Weil Marcin Nabiałek ist Methode erzeugt neue Routen auf der Grundlage der locale_prefix dynamisch, caching, Sie würde einen 404 Fehler auf den Besuch einer Präfix nicht gespeichert in der locale_prefix variable zum Zeitpunkt der Zwischenspeicherung.

---

Was halten wir?

Die foundation scheint sehr solide und wir können halten die meisten es!

Können wir sicherlich halten die verschiedenen Lokalisierung-spezifische route-Dateien:

<?php

//app/lang/pl/routes.php

return array(

    'contact' => 'kontakt',
    'about'   => 'o-nas'
);

Können wir halten auch alle die app/config/app.php Variablen:

/**
* Default locale 
*/
'locale' => 'pl'

/**
 * List of alternative languages (not including the one specified as 'locale')
 */
'alt_langs' => array ('en', 'fr'),

/**
 *  Prefix of selected locale  - leave empty (set in runtime)
 */
'locale_prefix' => '',

 /**
 * Let's also add a all_langs array
 */
'all_langs' => array ('en', 'fr', 'pl'),

Müssen wir auch das Stück code, der überprüft die route Segmente. Aber da der Punkt von diesem ist zu nutzen, um den cache müssen wir verschieben Sie Sie außerhalb der routes.php - Datei. Dass man nicht mehr verwendet werden, sobald wir die cache-Routen. Wir können für die Zeit, verschieben Sie es auf app/Providers/AppServiceProver.php zum Beispiel:

public function boot(){
  /*
   *  Set up locale and locale_prefix if other language is selected
   */
   if (in_array(Request::segment(1), config('app.alt_langs'))) {
       App::setLocale(Request::segment(1));
       config([ 'app.locale_prefix' => Request::segment(1) ]);
   }
}

Nicht vergessen:

use Illuminate\Support\Facades\Request;
use Illuminate\Support\Facades\App;

---

Unsere Routen:

Mehrere Veränderungen innerhalb unserer app/Http/routes.php Datei.

Erstens haben wir eine neue array enthält alle alt_langs sowie die Standard -locale_prefix, die würde wahrscheinlich '':

$all_langs = config('app.all_langs');

Um der Lage sein, um cache all die verschiedenen lang-Präfixe mit übersetzten Parameter der route müssen wir registrieren Sie alle. Wie können wir das tun?

*** Laravel aside 1: ***

Werfen wir einen Blick auf die definition von Lang::get(..):

public static function get($key, $replace = array(), $locale = null, $fallback = true){
      return \Illuminate\Translation\Translator::get($key, $replace, $locale, $fallback);
}

Den Dritten parameter der Funktion ist ein $locale variable! Toll - wir können sicher auch, dass zu unserem Vorteil! Diese Funktion tatsächlich lassen Sie uns wählen Sie das Gebietsschema wir möchten, erhalten Sie die übersetzung von!

Die nächste Sache, die wir tun werden, ist die Iteration über die $all_langs array und erstellen Sie eine neue Route Gruppe für jede Sprache ein Präfix. Nicht nur das, sondern wir gehen auch, um loszuwerden, das where Ketten und patterns, die wir bisher gebraucht, und nur registrieren die Strecken mit Ihren richtigen übersetzungen (andere werfen 404 ohne vorher zu prüfen, für die es mehr):

/**
* Iterate over each language prefix 
*/
foreach( $all_langs as $prefix ){

   if ($prefix == 'pl') $prefix = '';

   /**
   * Register new route group with current prefix
   */
   Route::group(['prefix' => $prefix], function() use ($prefix) {

         //Now we need to make sure the default prefix points to default  lang folder.
         if ($prefix == '') $prefix = 'pl';

         /**
         * The following line will register:
         *
         * example.com/
         * example.com/en/
         */
         Route::get('/', 'MainController@getHome')->name('home');

         /**
         * The following line will register:
         *
         * example.com/kontakt
         * example.com/en/contact
         */
         Route::get(Lang::get('routes.contact',[], $prefix) , 'MainController@getContact')->name('contact');

         /**
         * “In another moment down went Alice after it, never once 
         * considering how in the world she was to get out again.”
         */
         Route::group(['prefix' => 'admin', 'middleware' => 'admin'], function () use ($prefix){

            /**
            * The following line will register:
            *
            * example.com/admin/uzivatelia
            * example.com/en/admin/users
            */
            Route::get(Lang::get('routes.admin.users',[], $prefix), 'AdminController@getUsers')
            ->name('admin-users');

         });
   });
}

/**
* There might be routes that we want to exclude from our language setup.
* For example these pesky ajax routes! Well let's just move them out of the `foreach` loop.
* I will get back to this later.
*/
Route::group(['middleware' => 'ajax', 'prefix' => 'api'], function () {
    /**
    * This will only register example.com/api/login
    */
    Route::post('login', 'AjaxController@login')->name('ajax-login');
});

---

Houston, wir haben ein problem!

Wie Sie sehen können, dass ich lieber mit benannten Routen (die meisten Menschen tun das wohl):

Route::get('/', 'MainController@getHome')->name('home');

Können Sie sehr leicht in Ihrer blade-templates:

{{route('home')}}

Aber es gibt ein Problem mit meiner Lösung bisher: Route-Namen überschreiben sich gegenseitig. Die foreach Schleife oben wäre nur registrieren, das Letzte vorangestellt Routen mit Ihren Namen.

In anderen Worten nur example.com/ wäre gebunden an die home route als locale_perfix war das Letzte Element in der $all_langs array.

Wir können dies umgehen, indem route-Namen mit der Sprache $prefix. Zum Beispiel:

Route::get('/', 'MainController@getHome')->name($prefix.'_home');

Wir haben dazu für jede der Strecken innerhalb unserer Schleife. Dies schafft ein weiteres kleines Hindernis.

---

Aber mein großes Projekt ist fast fertig!

Gut, wie Sie wahrscheinlich schon erraten, die Sie jetzt haben, um zurück zu gehen, um alle Ihre Dateien und Präfix jedes route Helfer-Aufruf mit den aktuellen locale_prefix geladen, aus der app config.

Außer Sie nicht!

*** Laravel aside 2: ***

Lassen Sie uns nehmen einen Blick an, wie Laravel implementiert es route Helfer-Methode.

if (! function_exists('route')) {
    /**
     * Generate a URL to a named route.
     *
     * @param  string  $name
     * @param  array   $parameters
     * @param  bool    $absolute
     * @return string
     */
    function route($name, $parameters = [], $absolute = true)
    {
        return app('url')->route($name, $parameters, $absolute);
    }
}

Wie Sie sehen können, Laravel, wird erst überprüft, wenn ein route Funktion existiert bereits. Es registriert seine route Funktion nur, wenn eine andere noch nicht vorhanden ist!

Was bedeutet, dass wir bekommen können, um unser problem sehr einfach ohne schreiben jeden einzelnen route nennen, die bisher in unserer Blade Vorlagen.

Let ' s machen ein app/helpers.php - Datei ganz schnell.

Stellen wir sicher, dass Laravel lädt die Datei, bevor es lädt seine helpers.php indem Sie die folgende Zeile in bootstrap/autoload.php

//Put this line here
require __DIR__ . '/../app/helpers.php';
//Right before this original line
require __DIR__.'/../vendor/autoload.php';

Alles, was wir jetzt tun müssen, ist unsere eigene route Funktion innerhalb unserer app/helpers.php - Datei. Wir verwenden die ursprüngliche Implementierung als Grundlage:

<?php
//Same parameters and a new $lang parameter
function route($name, $parameters = [], $absolute = true, $lang = null)
{
    /*
    * Remember the ajax routes we wanted to exclude from our lang system?
    * Check if the name provided to the function is the one you want to
    * exclude. If it is we will just use the original implementation.
    **/
    if (str_contains($name, ['ajax', 'autocomplete'])){
        return app('url')->route($name, $parameters, $absolute);
    }

   //Check if $lang is valid and make a route to chosen lang
   if ( $lang && in_array($lang, config('app.alt_langs')) ){
       return app('url')->route($lang . '_' . $name, $parameters, $absolute);
   }

    /**
    * For all other routes get the current locale_prefix and prefix the name.
    */
    $locale_prefix = config('app.locale_prefix');
    if ($locale_prefix == '') $locale_prefix = 'pl';
    return app('url')->route($locale_prefix . '_' . $name, $parameters, $absolute);
}

---

Das ist es!

So, was wir getan haben, ist im wesentlichen registrierten alle, die Präfix-Gruppen zur Verfügung. Erstellt jeder Weg übersetzt und mit es der name vorangestellt. Und dann Art überschrieben die Laravel route Funktion als Präfix die gesamte route mit Namen (außer ein paar) mit den aktuellen locale_prefix so, dass die entsprechenden urls erstellt werden, in unserer blade-templates, ohne config('app.locale_prefix') jede einzelne Zeit.

Ach ja:

php artisan route:cache

Caching-Routen sollte eigentlich nur einmal gemacht werden, die Sie bereitstellen, Ihr Projekt, da es sehr wahrscheinlich ist Sie Durcheinander wird mit Ihnen während devlopement. Aber Sie können immer den cache löschen:

php artisan route:clear

Nochmals vielen Dank an Marcin Nabiałek für seine ursprüngliche Antwort. Es war wirklich hilfreich für mich.

InformationsquelleAutor PeterTheLobster