Поиск
Справочник

Файл .env Laravel на рабочем сайте: какие строки поменять

В файле .env лежат настройки, которые отличаются от сервера к серверу: адрес сайта, пароль базы, почта. Образец .env.example настроен для компьютера разработчика — на рабочем сайте в нём нужно поменять несколько строк, закрыть файл от чужих глаз и собрать кеш настроек. Ниже — какие строки, на что и как проверить.

≈ 7 мин чтения
Содержание 14

Что сделать прямо сейчас

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Если .env ещё нет — скопируйте образец: cp .env.example .env.
  3. Откройте файл: nano .env — и поменяйте строки из таблицы ниже.
  4. Закройте файл от чужих: sudo chown $USER:www-data .env и chmod 640 .env.
  5. Примените настройки: sudo -u www-data php artisan config:cache.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Вместо example.com подставьте свой домен.

Какие строки поменять

СтрокаВ образцеНа рабочем сайте
APP_NAMELaravelназвание сайта, с пробелами — в кавычках
APP_ENVlocalproduction
APP_KEYпустоключ от php artisan key:generate
APP_DEBUGtruefalse
APP_URLhttp://localhost:8000https://example.com
DB_CONNECTIONsqlitemysql, если база — MySQL
MAIL_MAILERlogsmtp
SESSION_SECURE_COOKIEстроки нетtrue, когда сайт работает по HTTPS

Остальные строки можно оставить как в образце. Строки Redis — в статье Laravel и Redis, строки журнала — в статье Журналы Laravel.

Строки приложения

APP_NAME="Мой сайт"
APP_ENV=production
APP_KEY=
APP_DEBUG=false
APP_URL=https://example.com
СтрокаЧто значит
APP_ENV=productionрабочий сайт: команды вроде migrate переспрашивают перед запуском
APP_DEBUG=falseпри ошибке посетитель видит короткую страницу 500, а текст ошибки уходит в журнал
APP_URLиз этого адреса Laravel строит ссылки в письмах и адреса загруженных файлов
APP_KEYключ шифрования — его создаёт команда php artisan key:generate

С APP_DEBUG=true при любой ошибке посетитель увидит пути к файлам, запросы к базе и настройки. На рабочем сайте так оставлять нельзя.

Ключ APP_KEY создайте один раз и больше не меняйте: с новым ключом пользователи разлогинятся, а данные, зашифрованные старым ключом, не расшифруются. Если ключа нет — разбор ошибки.

Часового пояса в .env нет: в новом проекте он прописан в файле config/app.php строкой 'timezone' => 'UTC'. Как это влияет на задачи по расписанию — в статье Планировщик Laravel.

База данных

В образце база — SQLite: файл database/database.sqlite в папке проекта. Для MySQL или MariaDB уберите знак # в начале строк и впишите свои значения:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=example
DB_USERNAME=example
DB_PASSWORD="пароль базы"

Базу и пользователя создайте заранее — Установка MySQL. Для PHP нужен модуль php-mysql. Если Laravel не подключается к базе — разбор.

Почта

С MAIL_MAILER=log Laravel не отправляет письма, а пишет их в журнал. Чтобы письма уходили, впишите данные почтового сервиса:

MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=site@example.com
MAIL_PASSWORD="пароль"
MAIL_FROM_ADDRESS="site@example.com"
MAIL_FROM_NAME="${APP_NAME}"

Адрес сервера, порт и пароль даёт почтовый сервис. Запись ${APP_NAME} подставляет значение строки APP_NAME.

Когда сайт работает по HTTPS, добавьте строку:

SESSION_SECURE_COOKIE=true

Тогда браузер отправляет cookie сессии только по защищённому соединению. Пока сайт открывается по http, строку не добавляйте: формы перестанут отправляться с ошибкой 419 Page Expired.

Как писать значения

Как записаноЧто получит Laravel
true или (true)логическое «да»
false или (false)логическое «нет»
null или (null)пустое значение null
empty или (empty)пустая строка
"Мой сайт"строка с пробелом
  • Значение с пробелами берите в двойные кавычки.
  • Пароль с символом # или пробелом тоже берите в кавычки.
  • Строка, которая начинается с #, — комментарий, Laravel её не читает.
  • Пробелов вокруг знака = не ставьте.

Права на .env

В .env лежат пароль базы и ключ шифрования. Читать файл должны только вы и сайт:

sudo chown $USER:www-data .env
chmod 640 .env
ls -l .env

В ответе в начале строки -rw-r-----, дальше ваш пользователь и группа www-data. Вы можете править файл, сайт — только читать, остальные пользователи сервера файл не видят. Подробнее о цифрах — chmod и Права на файлы сайта.

nginx файл .env посетителям не отдаёт, если папка сайта — public, а в файле сайта есть блок с deny all — nginx для Laravel.

Почему .env нет в Git

В файле .gitignore нового проекта есть строки .env, .env.backup и .env.production — Git эти файлы не сохраняет. Документация Laravel объясняет так: у каждого сервера свои настройки, а пароли из репозитория увидит любой, кто получит к нему доступ.

Проверьте в папке проекта:

git check-ignore .env

Если в ответе .env — файл в Git не попадёт. После git clone на новом сервере .env создают заново из .env.example.

Если .env всё же нужно хранить в репозитории, Laravel умеет его шифровать: команда php artisan env:encrypt создаёт файл .env.encrypted и показывает ключ. Сохраните ключ в надёжном месте — без него файл не расшифровать. На сервере файл расшифровывает команда php artisan env:decrypt --key=ключ.

Как применить правки

На рабочем сайте Laravel берёт настройки из кеша bootstrap/cache/config.php, если его собрали командой config:cache или optimize. Тогда .env не читается совсем. После каждой правки .env соберите кеш заново:

sudo -u www-data php artisan config:cache

Ответ: Configuration cached successfully.

Если работают воркеры очереди, перезапустите их — они держат старые настройки в памяти: php artisan queue:restart. Подробнее — Очереди и Supervisor.

Как проверить

php artisan env
php artisan about --only=environment

Первая команда ответит The application environment is [production]. Вторая покажет режим отладки — в строке Debug Mode должно быть OFF, — адрес сайта и часовой пояс. Подробнее — php artisan about.

Посмотреть все значения одного файла настроек можно командой php artisan config:show app. В ответе будет и ключ APP_KEY — не пересылайте этот вывод никому.

Ошибки и как их исправить

Что видитеПричинаЧто делать
правка .env не действуетсобран кеш настроексоберите кеш заново
No application encryption key has been specified.пустая строка APP_KEYРазбор
SQLSTATE[HY000] [2002]неверный DB_HOST или MySQL не запущенРазбор
SQLSTATE[HY000] [1045] Access denied for userневерный логин или пароль базыРазбор
в ссылках и адресах картинок localhostв APP_URL адрес из образцавпишите адрес сайта и соберите кеш
419 Page Expired после правки .envSESSION_SECURE_COOKIE=true, а сайт открыт по httpРазбор
письма не приходят, а появляются в журналеMAIL_MAILER=logвпишите SMTP
laravel.log could not be openedнет прав на storageРазбор

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше