Настройка laravel lang: файлы переводов и смена языка
Каталога lang в свежем проекте Laravel нет: его публикует команда php artisan lang:publish. После этого переводы лежат в lang/en, а язык приложения задаёт APP_LOCALE в .env.
01Проверьте версию Laravel и наличие каталога lang
Зайдите в каталог проекта и посмотрите версию фреймворка. Команда php artisan --version печатает строку вида Laravel Framework 13.x. Затем проверьте, есть ли каталог lang: в свежем проекте его нет, и ls lang завершится ошибкой No such file or directory.
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 берёт переводы из проекта, а не из пакета.
php artisan lang:publish
ls lang/en
03Задайте язык приложения в.env
Откройте .env и проверьте строку APP_LOCALE. В свежем проекте там en. Значение ru включает русские переводы, если файлы для них есть в lang/ru. Строка APP_FALLBACK_LOCALE=en задаёт язык, на который Laravel переходит, когда перевода нет.
APP_LOCALE=ru
APP_FALLBACK_LOCALE=en
04Создайте файл перевода для русского языка
Скопируйте английские файлы в каталог lang/ru и переведите значения. Ключи слева от => не меняют: по ним Laravel ищет строку. Для собственных сообщений создайте отдельный файл, например lang/ru/messages.php, и вызывайте перевод функцией __('messages.welcome').
mkdir -p lang/ru
cp lang/en/validation.php lang/ru/validation.php
05Смените язык на лету в коде
Язык на один запрос переключает App::setLocale('ru'). В контроллере или middleware это работает без правки .env. Значение сохраняется до конца запроса, следующий запрос снова берёт APP_LOCALE.
use Illuminate\Support\Facades\App;
App::setLocale('ru');
return __('validation.required');
06Сбросьте кэш конфига и проверьте результат
После правки .env при закэшированном конфиге новое значение не подхватится. Выполните php artisan config:clear или php artisan optimize. Проверьте перевод командой php artisan tinker или на странице: текст валидации должен выводиться по-русски.
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 PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы