Файл .env — одна из важнейших частей любого Laravel-проекта. Именно через него настраиваются:

база данных;
режим работы приложения;
почта;
очереди;
кеш;
API-ключи;
production-конфигурация.

Разберём, как правильно работать с .env в Laravel.

Что такое .env в Laravel

Laravel использует переменные окружения для безопасной настройки проекта.

Основная идея:

не хранить чувствительные данные в коде;
разделять local/dev/prod конфигурации;
упростить деплой.

Где находится файл .env

Файл расположен в корне проекта:

project/.env

После установки Laravel обычно создаётся из:

.env.example

Основные настройки Laravel ENV

APP_NAME

APP_NAME=Laravel

Название проекта.

APP_ENV

APP_ENV=local

Варианты:

local
production
staging

APP_DEBUG

APP_DEBUG=true

В production всегда должно быть:

APP_DEBUG=false

Настройка базы данных Laravel

MySQL

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

Генерация APP_KEY

После установки Laravel обязательно выполните:

php artisan key:generate

Laravel создаст:

APP_KEY=base64:...

Без APP_KEY не будут работать:

сессии;
шифрование;
cookies.

Настройка очередей

Database Queue

QUEUE_CONNECTION=database

Redis Queue

QUEUE_CONNECTION=redis

Настройка Redis

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

Настройка почты

Пример SMTP:

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=tls

Безопасность .env

Никогда не коммитьте .env

Файл должен находиться в .gitignore.

Как очистить кеш конфигурации

После изменения .env:

php artisan config:clear

или:

php artisan optimize:clear

Production настройки Laravel

Для production:

APP_ENV=production
APP_DEBUG=false

Также рекомендуется:

включить кеш конфигов;
использовать Redis;
настроить queue workers.

Полезные Artisan команды

Кеш конфигурации

php artisan config:cache

Очистка кеша

php artisan cache:clear

Итоги

Файл .env — основа конфигурации Laravel.

Правильная настройка переменных окружения помогает:

повысить безопасность;
упростить деплой;
ускорить разработку;
разделять dev/prod окружения.

Понимание работы Laravel ENV обязательно для любого Laravel-разработчика. 👉 Заказать бесплатный экспресс-аудит проекта

"Работа с файлом .env в Laravel: настройка переменных окружения"