К содержимому

Настройка laravel lang: файлы переводов и смена языка

Каталога lang в свежем проекте Laravel нет: его публикует команда php artisan lang:publish. После этого переводы лежат в lang/en, а язык приложения задаёт APP_LOCALE в .env.

Руководство Laravel 2 мин чтения

01Проверьте версию Laravel и наличие каталога lang

Зайдите в каталог проекта и посмотрите версию фреймворка. Команда php artisan --version печатает строку вида Laravel Framework 13.x. Затем проверьте, есть ли каталог lang: в свежем проекте его нет, и ls lang завершится ошибкой No such file or directory.

bash
cd /var/www/example.com
php artisan --version
ls lang

02Опубликуйте каталог lang

Команда php artisan lang:publish создаёт каталог lang и копирует в него файлы переводов фреймворка. После неё появляется lang/en с файлами auth.php, pagination.php, passwords.php и validation.php. Эти файлы можно править: Laravel берёт переводы из проекта, а не из пакета.

bash
php artisan lang:publish
ls lang/en

03Задайте язык приложения в.env

Откройте .env и проверьте строку APP_LOCALE. В свежем проекте там en. Значение ru включает русские переводы, если файлы для них есть в lang/ru. Строка APP_FALLBACK_LOCALE=en задаёт язык, на который Laravel переходит, когда перевода нет.

ini
APP_LOCALE=ru
APP_FALLBACK_LOCALE=en

04Создайте файл перевода для русского языка

Скопируйте английские файлы в каталог lang/ru и переведите значения. Ключи слева от => не меняют: по ним Laravel ищет строку. Для собственных сообщений создайте отдельный файл, например lang/ru/messages.php, и вызывайте перевод функцией __('messages.welcome').

bash
mkdir -p lang/ru
cp lang/en/validation.php lang/ru/validation.php

05Смените язык на лету в коде

Язык на один запрос переключает App::setLocale('ru'). В контроллере или middleware это работает без правки .env. Значение сохраняется до конца запроса, следующий запрос снова берёт APP_LOCALE.

php
use Illuminate\Support\Facades\App;

App::setLocale('ru');
return __('validation.required');

06Сбросьте кэш конфига и проверьте результат

После правки .env при закэшированном конфиге новое значение не подхватится. Выполните php artisan config:clear или php artisan optimize. Проверьте перевод командой php artisan tinker или на странице: текст валидации должен выводиться по-русски.

bash
php artisan config:clear
php artisan tinker --execute="echo __('validation.required');"

Частые ошибки

  • Команда ls lang падает с No such file or directory, потому что в свежем проекте Laravel каталога lang нет.

    Выполните php artisan lang:publish, команда создаст lang и файлы lang/en.

  • После правки APP_LOCALE в .env язык на сайте не меняется.

    Конфиг закэширован: выполните php artisan config:clear или php artisan optimize, затем обновите страницу.

  • В lang/ru переведены значения, но Laravel всё равно показывает английский текст.

    Проверьте, что ключи в файле совпадают с lang/en, а имя каталога равно значению APP_LOCALE. Для ru нужен именно lang/ru.

Deploykin

Как это делается в Deploykin

В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Нужно ли создавать каталог lang вручную?

Нет. В свежем проекте Laravel каталога lang нет, его публикует команда php artisan lang:publish. Она создаёт lang/en с файлами переводов фреймворка.

Где Laravel ищет файлы переводов?

В каталоге lang проекта, в подкаталоге с именем локали, например lang/ru. Если файла там нет, Laravel берёт перевод из APP_FALLBACK_LOCALE.

Как перевести сообщения валидации на русский?

Опубликуйте lang, скопируйте lang/en/validation.php в lang/ru/validation.php, переведите значения и задайте APP_LOCALE=ru. После правки .env сбросьте кэш конфига командой php artisan config:clear.

Почему после смены APP_LOCALE текст остался прежним?

Скорее всего, закэширован конфиг. Выполните php artisan config:clear или php artisan optimize, чтобы Laravel прочитал новое значение из .env.

Ещё по теме

Laravel: руководство по установке и настройке: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.