Локализация

Введение

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

Языковые файлы

Языковые строки хранятся в папке app/lang. Внутри неё должны располагаться подпапки — языки, поддерживаемые приложением:

/app
  /lang
    /en
      messages.php
    /es
      messages.php

Пример языкового файла

Языковые файлы (скрипты) просто возвращают массив пар ключ/значение. Например:

<?php

return array(
  'welcome' => 'Добро пожаловать на мой сайт!'
);

Изменение языка по умолчанию «на лету»

Язык по умолчанию указан в файле настроек app/config/app.php. Вы можете изменить текущий язык во время работы вашего приложения методом PHPApp::setLocale():

App::setLocale('es');

'fallback_locale' => 'en',

Основы использования

Получение строк из языкового файла

echo Lang::get('messages.welcome');

Первый компонент, передаваемый методу PHPget() — имя языкового файла, а затем указывается имя строки, которую нужно получить.

Внимание: если строка не найдена, то метод PHPget() вернёт её путь (ключ).

Вы также можете использовать функцию PHPtrans() — короткий способ вызова метода PHPLang::get():

echo trans('messages.welcome');

Замена параметров внутри строк

Сперва определите параметр в языковой строке:

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

Затем передайте массив вторым аргументом методу PHPLang::get():

echo Lang::get('messages.welcome', array('name' => 'Dayle'));

Проверка существования языковой строки

if (Lang::has('messages.welcome')) {
  //
}

Множественное число

Формы множественного числа — проблема для многих языков, так как все они имеют разные сложные правила для их получения. Однако вы можете легко справиться с ней в ваших языковых файлах используя символ | для разделения форм единственного и множественного числа.

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

Для получения такой строки используется метод PHPLang::choice():

echo Lang::choice('messages.apples', 10);

echo Lang::choice('товар|товара|товаров', $count, array(), 'ru');

Благодаря тому, что Laravel использует компонент Symfony Translation вы можете легко создать более точные правила для проверки числа:

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

Проверка ввода

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