Laravel: No application encryption key has been specified — нет ключа APP_KEY
Laravel шифрует ключом APP_KEY cookie и сессии посетителей. Ключ хранится в файле .env в папке проекта. Если строка APP_KEY пустая или файла .env нет, Laravel не может работать и показывает эту ошибку. Ключ создаёт одна команда — php artisan key:generate.
Содержание 11
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Проверьте, есть ли файл настроек:
ls -a .env. - Если файла нет, создайте его из образца:
cp .env.example .env. - Создайте ключ:
php artisan key:generate. - Если настройки были закешированы, обновите кеш:
php artisan config:cache.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). В папке проекта лежат файл artisan и папки public и storage.
Как выглядит ошибка
No application encryption key has been specified.С APP_DEBUG=true в файле .env этот текст виден на странице ошибки. С APP_DEBUG=false посетитель видит 500 и Server Error, а текст ошибки записан в storage/logs/laravel.log.
Посмотреть, есть ли ключ:
grep '^APP_KEY=' .envКлюча нет, если в ответе только APP_KEY=. Рабочий ключ выглядит так: APP_KEY=base64: и дальше длинная строка из букв и цифр.
Откуда берётся ключ
В новом проекте Laravel файл .env создаётся из образца .env.example. В образце строка ключа пустая: APP_KEY=. Ключ создаётся при установке проекта командой composer create-project: она сама запускает php artisan key:generate.
Ключ пропадает, когда проект переносят на сервер:
- файл .env не загрузили — его не хранят в Git, потому что в нём пароли;
- .env создали заново из
.env.example, а ключ не создали.
Как создать ключ
php artisan key:generateКоманда создаёт случайный ключ и вписывает его в строку APP_KEY= файла .env. В ответе:
Application key set successfully.Команду запускайте от пользователя, которому принадлежит файл .env. Если .env принадлежит www-data — sudo -u www-data php artisan key:generate.
Если ключ в файле уже есть, а сайт работает в режиме production — в .env стоит APP_ENV=production, — команда переспросит, точно ли менять ключ. Ответьте no, если ключ уже рабочий: почему — в разделе ниже.
| Вариант | Что делает |
|---|---|
php artisan key:generate | создаёт ключ и пишет его в .env |
php artisan key:generate --show | только показывает новый ключ, в .env не пишет |
php artisan key:generate --force | меняет ключ без вопроса — на рабочем сайте не используйте |
Если ключ есть, а ошибка осталась
Настройки могли быть закешированы командой php artisan config:cache или php artisan optimize. Тогда Laravel читает настройки из кеша, а не из .env. Обновите кеш:
php artisan config:cacheЕсли кеш настроек не нужен, удалите его: php artisan config:clear.
Если ошибка осталась, проверьте, что правите тот проект, который открывает сайт. Папка сайта указана в настройке root в nginx: grep -R 'root ' /etc/nginx/sites-enabled/. Для Laravel там папка public внутри проекта.
Если пишет Unable to set application key
Unable to set application key. No APP_KEY variable was found in the .env file.В файле .env нет строки APP_KEY=. Откройте файл: nano .env — и добавьте в начало строку:
APP_KEY=Сохраните: Ctrl+O, Enter, выход — Ctrl+X. Снова выполните php artisan key:generate.
Unable to set application key. APP_KEY is already present in the environment.Команда не нашла в .env строку с текущим ключом и видит, что APP_KEY задан в переменных окружения. Проверьте: printenv APP_KEY. Если ответ не пустой, ключ задан вне .env — например, командой export. Поменяйте его там, где он задан.
Если пишет Unsupported cipher or incorrect key length
Unsupported cipher or incorrect key length. Supported ciphers are: aes-128-cbc, aes-256-cbc, aes-128-gcm, aes-256-gcm.Ключ есть, но длина не подходит. Для шифра aes-256-cbc, который стоит в Laravel по умолчанию, нужен ключ из 32 байт. Ключ из key:generate начинается с base64: — так Laravel понимает, что строку нужно раскодировать.
Ошибка появляется, если ключ скопировали не полностью или без начала base64:. Сравните строку с рабочей копией .env — например, со старого сервера. Если рабочего ключа нигде нет, создайте новый: php artisan key:generate --force, но прочтите сначала раздел ниже.
Почему ключ нельзя менять без нужды
По документации Laravel, после смены ключа:
- все посетители выйдут из своих учётных записей — cookie сессий зашифрованы старым ключом;
- данные, которые приложение зашифровало старым ключом, нельзя будет расшифровать.
Если ключ всё же меняете, старый можно оставить в строке APP_PREVIOUS_KEYS файла .env. Тогда Laravel сможет прочитать то, что зашифровано старым ключом:
APP_KEY=base64:новый-ключ
APP_PREVIOUS_KEYS=base64:старый-ключЕсли старых ключей несколько, их пишут через запятую.
Ключ — секрет: по нему можно подделать cookie сайта. Не публикуйте .env и не храните его в Git.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
No application encryption key has been specified. | пустой APP_KEY или нет файла .env | создайте ключ |
| ключ есть, ошибка осталась | настройки закешированы | обновите кеш |
No APP_KEY variable was found in the .env file. | в .env нет строки APP_KEY | добавьте строку |
APP_KEY is already present in the environment. | ключ задан вне .env | найдите, где задан |
Unsupported cipher or incorrect key length. | ключ скопирован не полностью | сравните с рабочей копией |
| все посетители разом вышли из учётных записей | ключ поменяли | верните старый ключ в APP_PREVIOUS_KEYS |
could not be opened in append mode | Laravel не может писать в журнал | Разбор |
Тексты сообщений сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Encryption — на английском: APP_KEY, key:generate, смена ключа и APP_PREVIOUS_KEYS.
- Документация Laravel: Configuration — на английском: файл .env и кеш настроек.
- Исходный код команды key:generate — на английском: тексты Application key set successfully и Unable to set application key.
- Исходный код Encrypter — на английском: шифры и длина ключа.
- Образец .env.example в Laravel — на английском: пустая строка APP_KEY.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- 500 Server Error в Laravelкак найти причину пустой страницы с ошибкой.
- 419 Page Expiredесли формы перестали отправляться.