如何在Laravel中创建多语种翻译路线

时间:2014-08-01 14:09:39

标签: php laravel laravel-4 localization routing

我想创建具有许多翻译路线的应用程序,具体取决于所选语言。我曾在3 methods of creating URLs in multilingual websites描述过它。

在这种情况下,它应该是提到的主题的第一个方法所以:

  1. 我有一种默认语言
  2. 我可以有很多其他语言
  3. 目前的语言只能通过网址(不含cookie /会话)计算,以使其对搜索引擎也非常友好
  4. 对于默认语言,URL中不应有前缀,因为其他语言应该是域
  5. 之后的语言前缀
  6. 网址的每个部分都应根据当前语言进行翻译。
  7. 我们假设我已设置默认语言pl和其他2种语言enfr。我只有3页 - 主页,联系页面和关于页面。

    网站的网址应该是这样的:

    /
    /[about]
    /[contact]
    /en
    /en/[about]
    /en/[contact]
    /fr
    /fr/[about]
    /fr/[contact]
    

    [about][contact]应根据所选语言进行翻译,例如英文版应保留contact,但对于波兰文,则应为kontakt,依此类推

    如何尽可能简单地完成?

3 个答案:

答案 0 :(得分:67)

第一步:

转到app/lang目录并在此处为每种语言的路线创建翻译。您需要创建3个routes.php文件 - 每个文件位于不同的语言目录(pl / en / fr)中,因为您要使用3种语言

波兰语:

<?php

// app/lang/pl/routes.php

return array(

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

英语:

<?php

// app/lang/en/routes.php

return array(
    'contact' => 'contact',
    'about'   => 'about-us'
);

法语:

<?php

// app/lang/fr/routes.php

return array(
    'contact' => 'contact-fr',
    'about'   => 'about-fr'
);

第二步:

转到app/config/app.php文件。

你应该找到一行:

'locale' => 'en',

并将其更改为应该是您的主要网站语言的语言(在您的情况下为波兰语):

'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' => '',

alt_langs配置中,您可以设置替代语言(在您的情况下为enfr) - 它们应与您创建包含翻译的文件的第一步中的文件名相同。 / p>

locale_prefix是您的语言环境的前缀。您不需要默认语言环境的前缀,因此将其设置为空字符串。如果将选择除默认语言之外的其他语言,则将在运行时修改此配置。

第三步

转到您的app/routes.php文件并输入其内容(这是app/routes.php文件的全部内容):

<?php

// app/routes.php

/*
|--------------------------------------------------------------------------
| Application Routes
|--------------------------------------------------------------------------
|
| Here is where you can register all of the routes for an application.
| It's a breeze. Simply tell Laravel the URIs it should respond to
| and give it the Closure to execute when that URI is requested.
|
*/


/*
 *  Set up locale and locale_prefix if other language is selected
 */
if (in_array(Request::segment(1), Config::get('app.alt_langs'))) {

    App::setLocale(Request::segment(1));
    Config::set('app.locale_prefix', Request::segment(1));
}


/*
 * Set up route patterns - patterns will have to be the same as in translated route for current language
 */
foreach(Lang::get('routes') as $k => $v) {
    Route::pattern($k, $v);
}


Route::group(array('prefix' => Config::get('app.locale_prefix')), function()
{
    Route::get(
        '/',
        function () {
            return "main page - ".App::getLocale();
        }
    );


    Route::get(
        '/{contact}/',
        function () {
            return "contact page ".App::getLocale();
        }
    );



    Route::get(
        '/{about}/',
        function () {
            return "about page ".App::getLocale();

        }
    );

});

如您所见,首先检查网址的第一段是否与您的语言名称匹配 - 如果是,则更改区域设置和当前语言前缀。

然后在微小的循环中,您为所有路由名称设置了要求(您提到要在URL中翻译aboutcontact),所以在此设置它们与{中定义的相同{1}}当前语言的文件。

最后,您创建的路由组的前缀与您的语言相同(对于默认语言,它将为空)和内部组,您只需创建路径,但这些参数routes.phpabout你视为contact,因此您可以使用variables{about}语法。

您需要记住,在这种情况下,将检查所有路线中的{contact}是否与您在当前语言的第一步中定义的相同。如果您不想要这种效果,并且想要使用where手动为每条路线设置路线,则可以选择{contact}替换app\routes.php文件而不分别为每条路线设置contactabout

<?php

// app/routes.php

/*
|--------------------------------------------------------------------------
| Application Routes
|--------------------------------------------------------------------------
|
| Here is where you can register all of the routes for an application.
| It's a breeze. Simply tell Laravel the URIs it should respond to
| and give it the Closure to execute when that URI is requested.
|
*/

/*
 *  Set up locale and locale_prefix if other language is selected
 */
if (in_array(Request::segment(1), Config::get('app.alt_langs'))) {

    App::setLocale(Request::segment(1));
    Config::set('app.locale_prefix', Request::segment(1));
}


Route::group(array('prefix' => Config::get('app.locale_prefix')), function()
{
    Route::get(
        '/',
        function () {
            return "main page - ".App::getLocale();
        }
    );


    Route::get(
        '/{contact}/',
        function () {
            return "contact page ".App::getLocale();
        }
    )->where('contact', Lang::get('routes.contact'));



    Route::get(
        '/{about}/',
        function () {
            return "about page ".App::getLocale();

        }
    )->where('about', Lang::get('routes.about'));


});

第四步:

你还没有提到它,但你可以考虑另外一件事。如果有人使用网址/en/something,其中something不正确路由,我认为是进行重定向的最佳解决方案。但是你应该重定向不到/因为它是默认语言而是/en

现在您可以打开app/start/global.php文件并在此处为未知网址创建301重定向:

// app/start/global.php

App::missing(function()
{
   return Redirect::to(Config::get('app.locale_prefix'),301);
});

答案 1 :(得分:21)

Marcin Nabiałek在初步答案中为我们提供的是路线定位问题的可靠解决方案。

小Bugbear:

他的解决方案唯一真正的缺点是我们不能使用缓存路由,根据Laravel's docs,这有时会带来很大好处:

  

如果您的应用程序专门使用基于控制器的路线,那么您   应该利用Laravel的路由缓存。使用路由缓存   将大大减少注册所有人的时间   您的应用程序的路线。在某些情况下,您的路线注册   甚至可能快100倍。要生成路由缓存,只需执行即可   route:cache Artisan命令。

为什么我们不能缓存路线?

由于Marcin Nabiałek's方法会动态生成基于locale_prefix的新路由,因此在访问未存储在404变量中的任何前缀时,缓存它们会导致locale_prefix错误缓存的时间。

我们保留什么?

基础似乎非常稳固,我们可以保留大部分内容!

我们当然可以保留各种特定于本地化的路径文件:

<?php

// app/lang/pl/routes.php

return array(

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

我们还可以保留所有app/config/app.php变量:

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

我们还需要一些检查路段的代码。但由于这一点是利用缓存,我们需要将其移到routes.php文件之外。一旦我们缓存路由,那个将不再使用。我们暂时可以将其移至app/Providers/AppServiceProver.php,例如:

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

别忘了:

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

设置我们的路线:

我们的app/Http/routes.php文件中会发生一些变化。

首先,我们必须创建一个新数组,其中包含所有alt_langs以及默认locale_prefix,其中很可能是''

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

为了能够使用已转换的路由参数缓存所有各种lang前缀,我们需要将它们全部注册。我们怎么能这样做?

*** Laravel aside 1: ***

让我们来看看Lang::get(..)的定义:

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

该函数的第三个参数是$locale变量!太棒了 - 我们当然可以利用它!这个功能实际上让我们选择我们想要从哪个语言环境获取翻译!

接下来我们要做的是迭代$all_langs数组并为每个语言前缀创建一个新的Route组。不仅如此,我们还将摆脱我们之前需要的where链和patterns,并且仅使用正确的翻译注册路线(其他人将抛出404不得不再检查一下):

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

休斯顿,我们遇到了问题!

正如你所看到的,我更喜欢使用命名路线(大多数人可能会这样做):

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

它们可以非常容易地在您的刀片模板中使用:

{{route('home')}}

但到目前为止我的解决方案存在问题:路由名称相互覆盖。上面的foreach循环只会注册带有名称的最后一个带前缀的路由。

换句话说,只有example.com/绑定到home路由,因为locale_perfix$all_langs数组中的最后一项。

我们可以通过在路径名前加上$prefix语言来解决这个问题。例如:

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

我们必须为循环中的每个路径执行此操作。这造成了另一个小障碍。

但我的大项目已基本完成!

好吧,您可能已经猜到了,现在必须回到所有文件,并使用从route配置加载的当前locale_prefix为每个app帮助函数调用添加前缀。

除非你没有!

*** Laravel aside 2: ***

让我们来看看Laravel如何实现它的route辅助方法。

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

如您所见,Laravel将首先检查是否已存在route函数。只有当另一个函数不存在时,它才会注册route函数!

这意味着我们可以非常轻松地解决我们的问题,而无需重写目前在我们的route模板中进行的每次Blade调用。

让我们快速制作一个app/helpers.php文件。

让我们确保Laravel在加载helpers.php之前加载文件,方法是将以下行添加到bootstrap/autoload.php

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

我们现在要做的就是在route文件中创建我们自己的app/helpers.php函数。我们将使用原始实现作为基础:

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

那就是它!

所以我们所做的基本上是注册了所有可用的前缀组。创建了每个翻译的路线,并且它的名称也带有前缀。然后排序覆盖Laravel route函数,将所有路径名称(除了一些)添加到当前locale_prefix前面,以便在我们的刀片模板中创建适当的URL而不必每次都输入config('app.locale_prefix')

哦是的:

php artisan route:cache

只有在部署项目后才能真正完成缓存路由,因为在开发过程中很可能会弄乱它们。但是你总是可以清除缓存:

php artisan route:clear

再次感谢Marcin Nabiałek的原始回答。这对我很有帮助。

答案 2 :(得分:0)

可以使用更简单的方法来应用相同的结果..并非完美,但确实提供了快速简便的解决方案。但是,在这种情况下,您必须编写每个路由,这样对于大型网站可能就不行了。

Route::get('/contact-us', function () {
    return view('contactus');
})->name('rte_contact'); // DEFAULT

Route::get('/contactez-nous', function () {
    return view('contactus');
})->name('rte_contact_fr');

只需在本地化文件中定义路由名称,如下所示:

# app/resources/lang/en.json
{ "rte_contact": "rte_contact" } //DEFAULT

// app/resources/lang/fr.json
{ "rte_contact": "rte_contact_fr" }

然后可以使用生成的语言环境变量在刀片服务器模板中使用它们,如下所示:

<a class="nav-link" href="{{ route(__('rte_contact')) }}"> {{ __('nav_contact') }}</a>