Файл .env Laravel на рабочем сайте: какие строки поменять
В файле .env лежат настройки, которые отличаются от сервера к серверу: адрес сайта, пароль базы, почта. Образец .env.example настроен для компьютера разработчика — на рабочем сайте в нём нужно поменять несколько строк, закрыть файл от чужих глаз и собрать кеш настроек. Ниже — какие строки, на что и как проверить.
Содержание 14
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Если .env ещё нет — скопируйте образец:
cp .env.example .env. - Откройте файл:
nano .env— и поменяйте строки из таблицы ниже. - Закройте файл от чужих:
sudo chown $USER:www-data .envиchmod 640 .env. - Примените настройки:
sudo -u www-data php artisan config:cache.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Вместо example.com подставьте свой домен.
Какие строки поменять
| Строка | В образце | На рабочем сайте |
|---|---|---|
APP_NAME | Laravel | название сайта, с пробелами — в кавычках |
APP_ENV | local | production |
APP_KEY | пусто | ключ от php artisan key:generate |
APP_DEBUG | true | false |
APP_URL | http://localhost:8000 | https://example.com |
DB_CONNECTION | sqlite | mysql, если база — MySQL |
MAIL_MAILER | log | smtp |
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.
Cookie и HTTPS
Когда сайт работает по 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 после правки .env | SESSION_SECURE_COOKIE=true, а сайт открыт по http | Разбор |
| письма не приходят, а появляются в журнале | MAIL_MAILER=log | впишите SMTP |
laravel.log could not be opened | нет прав на storage | Разбор |
Источники
- Документация Laravel: Configuration — на английском: значения true, false, null и empty, кавычки, env:encrypt и config:cache.
- Файл .env.example нового проекта Laravel — на английском: строки образца.
- Файл .gitignore нового проекта Laravel — на английском: .env, .env.backup и .env.production.
- Шаблон config/session.php — на английском: строка SESSION_SECURE_COOKIE.
- Документация Laravel: Mail — на английском: драйвер log пишет письма в журнал.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- php artisan optimizeкеш настроек, маршрутов и шаблонов.
- Ошибки Laravelчто значит сообщение и как его исправить.