Пошаговая локализация Laravel [руководство]

Выведите свой бизнес на новый уровень с глобальным расширением. Рост и развитие бизнеса.
Оглавление

Laravel — это мощный инструмент, позволяющий разработчикам создавать многоязычные сайты. Внедрив веб-локализацию в свои проекты на Laravel , вы сможете обеспечить персонализированный пользовательский опыт для посетителей с разными языковыми предпочтениями, что в конечном итоге расширит вашу аудиторию и повысит вовлечённость пользователей.

Мы проведём вас через процесс внедрения локализации в ваше приложение Laravel и познакомим с инструментом, который может упростить и улучшить ваши усилия по локализации!

Почему стоит локализовать сайт на Laravel ?

Мужчина в оранжевом жилете держит планшет с картой мира. Показаны флаги различных стран.

Вот несколько важных причин, по которым вам следует локализовать ваш сайт на Laravel .

  • Охватите глобальную аудиторию: Локализуя свой сайт на Laravel , вы можете расширить охват вашего приложения до международной аудитории. Это позволяет пользователям из разных стран и с разными языковыми предпочтениями понимать ваш контент и взаимодействовать с ним.
  • Улучшает пользовательский опыт: Локализация позволяет пользователям взаимодействовать с приложением на их родном языке, что значительно улучшает пользовательский опыт. Это может повысить показатели вовлечённости, снизить показатели отказов и увеличить конверсии.
  • Конкурентное преимущество: На конкурентном глобальном рынке предложение приложений на нескольких языках может дать значительное преимущество перед конкурентами. Это демонстрирует вашу приверженность международным рынкам и может помочь вам более эффективно выйти на новые рынки.
  • Улучшает SEO: Хорошо локализованные сайты, как правило, лучше ранжируются в поисковых системах по запросам на определённом языке. Это может увеличить трафик вашего блога и онлайн-видимость на различных рынках благодаря многоязычному переводу.

Требования к многоязычной локализации Laravel

Два человека совместно работают на большом компьютерном экране с различными приложениями. Похоже, они работают вместе.

При внедрении многоязычной локализации в Laravelесть несколько требований и шагов, которые следует учесть.

  • Чтобы получить доступ к новейшим функциям локализации, убедитесь, что вы используете последнюю версию Laravel (например, версию 10.x).
  • Базовое понимание PHP и фреймворка Laravel будет полезно в процессе внедрения.
  • Настройте локальную среду разработки или сервер, поддерживающий Laravel, включая веб-сервер и базу данных.
  • С самого начала определите, какие языки будет поддерживать ваше приложение.

Простые переводы в Laravel

Мужчина работает за ноутбуком. На экране — веб-браузер.

После понимания того, каким требованиям необходимо соответствовать перед переводом приложения или веб-сайта на Laravel , мы приведем несколько шагов для простого перевода Laravel .

Для этого откройте файл представления, который вы хотите локализовать, например resources/views/welcome.blade.php. Затем замените тег body следующим кодом.

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

Как видите, текст выше сейчас написан прямо в коде. Это менее эффективно и затрудняет перевод сайтов на разные языки (интернационализацию). 

Мы сделаем приведённый выше текст более гибким, чтобы его можно было легко адаптировать к разным языкам. Laravel предоставляет для этого очень полезную функцию — систему локализации. В качестве первого шага замените существующий текст следующим кодом.

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

Laravel по умолчанию отобразит указанный выше текст и выполнит поиск перевода, если пользователь выберет язык, отличный от английского. В этом случае английский будет использоваться в качестве языка приложения по умолчанию.

Настройка локалей в Laravel многоязычном веб-сайте

Два человека работают за компьютерными экранами. Они взаимодействуют с большими дисплеями.

Но как Laravel определяет текущий язык или узнает, какие языки доступны в приложении? Он проверяет настройки локали в файле config/app.php. Откройте этот файл и найдите следующие два ключа.

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

				
			

Объяснение над ключами должно быть понятным. Вкратце, ключ locale хранит локаль по умолчанию для вашего приложения (если в коде не указана другая локаль). Параметр fallback_locale активируется, если в вашем приложении запрашивается несуществующая локаль.

Теперь добавим в этот файл новый ключ, который будет содержать список всех поддерживаемых языковых версий.

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

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


				
			

На данный момент мы попробовали Laravel веб для поддержки трёх языков, а именно английского, итальянского и французского.

Обзор файлов переводов Laravel

Женщина указывает на большой компьютерный экран, на котором отображаются различные красочные значки. Экран имеет белый фон с синими и фиолетовыми значками.

В Laravel, как и во многих других фреймворках, переводы для разных языков хранятся в отдельных файлах. Для организации этих файлов переводов используются два метода.

Старый метод хранит файлы в следующей структуре: resources/lang/{en,fr,it}/{myfile.php}. Новый метод использует JSON-файлы, такие как resources/lang/{fr.json, it.json}. В этой статье основное внимание будет уделено новому методу, хотя принципы схожи со старым методом, за исключением различий в том, как называются и используются ключи перевода.

Для языков с региональными вариантами следует называть каталоги или файлы языков в соответствии со стандартом ISO 15897. Например, британский английский должен называться en_GB, а не en-gb.

Общая информация

В Laravel, как и во многих фреймворках, переводы для разных языков хранятся в отдельных файлах. Существует два основных способа организации файлов перевода Laravel .

  1. Традиционный подход предполагает хранение файлов по следующему пути: resources/lang/{en,fr,it}/{myfile.php}.
  2. Современный подход использует файлы resources/lang/{fr.json, it.json}.

В этой статье основное внимание будет уделено второму методу, хотя принципы применимы к обоим (с различиями в именовании и доступе к ключам перевода).

Для языков, которые различаются по регионам, рекомендуется называть каталоги и файлы языков в соответствии со стандартами ISO 15897. Например, британский английский следует обозначать как en_GB, а не en-gb.

Создание файлов переводов Laravel

Настроив локали для нашего приложения, мы можем приступить к переводу нашего приветственного сообщения по умолчанию.

Давайте начнём с создания новых файлов локализации в формате JSON в каталоге resources/lang. Сначала мы создадим файл resources/lang/it.json и заполним его соответствующими переводами.

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

				
			

Далее добавьте файл resources/lang/fr.json.

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

				
			

Как вы можете заметить, мы постоянно ссылаемся на сообщение по умолчанию из файла welcome.blade.php ({{ __(‘Добро пожаловать на сайт Linguise !’) }}). Нет необходимости создавать файл en.json, так как Laravel автоматически распознаёт, что сообщения по умолчанию на английском языке.

Настройка переключателя языков в Laravel мультиязычном приложении

Люди взаимодействуют с большим интерфейсом электронной почты.

Кроме того, Laravel ещё не настроен для переопределения локального языка, поэтому пока мы будем обрабатывать перевод непосредственно в маршруте. Измените стандартный маршрут приветствия внутри файла routes/web.php следующим образом.

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

В этом случае мы захватываем необязательный GET-параметр locale и устанавливаем текущую локаль на его основе (если запрошенная локаль поддерживается).

Теперь вы можете посетить свой сайт и добавить любой из поддерживаемых языков в качестве первого сегмента URL. Например, переход по адресу localhost/it или localhost/fr отобразит локализованный контент. Если вы не укажете локаль или выберете неподдерживаемую, Laravel по умолчанию будет использовать английский (en).

Промежуточное программное обеспечение для локализации Laravel

Включать локаль в каждый URL может быть не лучшим решением и способно нарушить визуальную привлекательность сайта. Чтобы решить эту проблему, мы настроим переключатель языка и будем использовать сессию пользователя для отображения переведённого контента. Вы можете создать новое промежуточное ПО в файле app/Http/Middleware/Localization.php или сгенерировать его, выполнив команду artisan make:middleware Localization.

Затем добавьте следующий код внутрь.

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


				
			

Это промежуточное ПО укажет Laravel использовать местоположение, выбранное пользователем, если эта опция присутствует в сессии.

Поскольку нам нужно, чтобы эта операция выполнялась при каждом запросе, добавьте её в стандартный стек промежуточного программного обеспечения в app/Http/Kernel.php для группы веб-промежуточного программного обеспечения.

				
					/**
* 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/web.php. Здесь мы используем замыкание в маршруте, но при желании вы можете разместить тот же код внутри контроллера.

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

				
			

Кроме того, удалите переключение локали, которое ранее было добавлено к маршруту приветствия по умолчанию. Теперь ваш корневой маршрут должен выглядеть так.

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

				
			

После этого пользователь сможет переключить активный язык только посетив localhost/language/{locale}. Выбранная локаль будет сохранена в сессии, а пользователи будут перенаправлены обратно на предыдущую страницу (как это обрабатывается промежуточным ПО локализации). 

Чтобы проверить это, перейдите по адресу localhost/language/it (при условии, что в вашем браузере активен файл cookie сессии), и вы должны увидеть переведённый контент. Вы можете перемещаться по сайту или обновить страницу, и выбранный язык останется активным.

Реализация переключения языка

Теперь нам нужно предоставить пользователю кликабельную возможность изменить переключатель языка Laravel веб , а не требовать от него вручную вводить коды локалей в URL. Для этого создайте простой переключатель языка. Добавьте новый файл по пути resources/views/partials/language_switcher.blade.php и вставьте следующий код.

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


				
			

Чтобы добавить только что созданный переключатель языков в представление «welcome», просто добавьте следующую строку в ваш файл welcome.blade.php в том месте, где вы хотите, чтобы отображался переключатель.

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


				
			

Откройте файл app/Providers/AppServiceProvider.php и добавьте следующий код в метод boot(), чтобы передавать текущую локаль во все представления при использовании переключателя языка

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


				
			

Расширенные возможности перевода в Laravel PHP

Иллюстрация людей, работающих над проектом. Команда сотрудничает.

В дальнейшем мы рассмотрим другие компоненты локализации, а именно дату, число и валюту. Вот шаги, которые необходимо выполнить.

Локализованные даты в Laravel

Работа с датами и временем имеет решающее значение в процессе локализации. Laravel использует Carbon для управления датами и временем. Вот как можно использовать Carbon для отображения локализованной даты.

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


				
			

Этот код устанавливает локаль Carbon на основе текущей локали приложения и соответствующим образом форматирует дату.

Чтобы отобразить локализованную дату в представлении:

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


				
			

Форматирование чисел и валют

В разных странах существуют различные способы форматирования чисел. Например….

  • Франция → 123 123,12
  • Германия → 123.123,12
  • Япония → 123 123

Чтобы учесть эти различия в вашем приложении Laravel , вы можете использовать NumberFormatter.

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

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

Вы также можете записывать числа словами на определённом языке.

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

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

Вот список валют. Для французской локали (`fr`) валюта будет отображаться в евро (€), а для американской локали (`en_US`) — в долларах США ($).

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

$currency2 = NumberFormatter::create('en_US', NumberFormatter::CURRENCY);
				
			
Преодолейте языковые барьеры
Попрощайтесь с языковыми барьерами и откройте безграничный рост! Попробуйте наш сервис автоматического перевода уже сегодня.

Альтернативное решение для локализации Laravel с помощью Linguise

Команда работает над цифровым проектом. Их окружают различные цифровые инструменты и символы.

После понимания этапов локализации Laravel , описанных в статье, этот процесс включает множество шагов, требующих от пользователей глубокого понимания программного кода Laravel .

Это, безусловно, может вызвать трудности у начинающих пользователей, которые хотят локализовать свои приложения. Поэтому необходимо более инновационное решение, способное обеспечить быстрый перевод, поддерживающее локализацию и требующее всего нескольких простых шагов для внедрения.

Одним из перспективных решений является Linguise. Linguise предлагает более простой и эффективный подход к локализации Laravel без необходимости глубоких знаний программирования. Ключевые возможности Linguise включают.

  • Простая интеграция с Laravel
  • Настройте переключатель языков без программирования
  • Перевод изображений
  • Редактор в реальном времени для адаптации переводов к местному контексту
  • Динамический перевод для динамически генерируемого контента
  • SEO-оптимизация для многоязычных версий

Шаги по установке Linguise на Laravel веб-сайты также можно выполнить легко. Вот краткое объяснение.

  1. Создайте аккаунт Linguise (используйте 30-дневную бесплатную пробную версию бесплатно)
  2. Зарегистрируйте свой веб-домен Laravel и введите некоторую информацию. Вы получите API-ключ.
  3. Загрузите и подключите скрипт перевода Linguise к папке Laravel , которую вы получили.
  4. Укажите языковые URL-адреса в файле .htaccess.
  5. Вставьте скрипт переключателя языков в раздел head вашего HTML.
  6. Настройте переключатель языков по своему усмотрению
  7. Переключатель языков появится на сайте Laravel , и контент будет переводиться автоматически.

Как это работает? С Linguiseвам нужно всего лишь зарегистрироваться и активировать приложение, и появится переключатель языков. После этого вы сможете локализовать контент, например, с помощью редактора в реальном времени, переводить медиафайлы, изображения и т. д.

Готовы выйти на новые рынки? Попробуйте наш сервис автоматического перевода бесплатно в течение 1 месяца без риска. Кредитная карта не требуется!

Conclusion

Локализация Laravel — это мощная функция, позволяющая разработчикам создавать многоязычные веб-сайты и приложения. Как мы видели, встроенный процесс локализации Laravel включает несколько этапов и требует хорошего понимания фреймворка. Это может быть сложно для новичков или тех, кто ищет более быстрое решение.

Такие инструменты, как Linguise , предлагают инновационную альтернативу для тех, кто ищет более простой подход. Эти решения обеспечивают быстрый перевод, легкую интеграцию и удобные функции, такие как настраиваемые переключатели языков и перевод изображений. Теперь создайте свою учетную запись Linguise и наслаждайтесь нашей функцией локализации вашего Laravel!

Вам также может быть интересно прочитать

Не пропустите!
Подпишитесь на нашу новостную рассылку

Получайте новости об автоматическом переводе сайтов, международном SEO и многом другом!

Invalid email address
Попробуйте. Одно сообщение в месяц, и вы можете отписаться в любое время.

Не уходите, не поделившись своей электронной почтой!

Мы не можем гарантировать, что вы выиграете в лотерею, но обещаем интересные информационные новости о переводе и occasional скидки.

Не пропустите!
Invalid email address