🐞
Безопасность

APP_DEBUG=true: опасная ошибка, оставленная на боевом сервере

20.11.2026
← Все статьи

При разработке на Laravel режим отладки очень удобен: при ошибке открывается красивая страница, где видно, в какой строке какого файла проблема, стек вызовов, данные запроса и состояние приложения. Проблема в том, что это удобство рассчитано на разработчика, а когда сайт выходит в интернет, ту же страницу может увидеть любой посетитель. Оставить APP_DEBUG=true в файле .env на боевом сервере — одна из самых частых и самых дорогих ошибок в Laravel-проектах.

Что на самом деле видно на странице ошибки

При включённом режиме отладки любое необработанное исключение выводит подробную страницу. В зависимости от версии Laravel и установленных пакетов на ней могут оказаться: полные пути к файлам на сервере, исходный код вокруг места ошибки, SQL-запрос к базе данных, заголовки запроса и cookie, данные сессии, а в некоторых случаях и переменные окружения. Среди переменных окружения могут быть пароль базы данных, пароль почтового сервера, API-ключи SMS-шлюза или платёжной системы.

Вызвать ошибку несложно. Достаточно отправить в форму значение неожиданного типа, пропустить обязательный параметр или попасть на момент, когда база данных временно не отвечает. Автоматические сканеры определяют сайты на Laravel, специально отправляют запросы, вызывающие ошибку, и проверяют, есть ли в ответе страница отладки.

Режим отладки и удалённое выполнение кода

Опасность режима отладки не ограничивается утечкой данных. В 2021 году в пакете Ignition, который выводит страницы ошибок Laravel, нашли серьёзную уязвимость (CVE-2021-3129): на сайтах с включённым режимом отладки и старой версией пакета злоумышленник мог выполнить на сервере свой код. Уязвимость исправлена, но урок из неё простой: инструментам для разработчика не место на боевом сервере. В типичном Laravel-проекте Ignition находится в разделе require-dev, поэтому установка на сервер через composer install --no-dev убирает его полностью.

Пример: электронный журнал школы

Для частной школы в Ташкенте запустили приложение по адресу maktab.example.uz, где ведутся оценки и посещаемость учеников. В день запуска разработчик временно включил режим отладки, чтобы быстрее видеть ошибки, а потом забыл его выключить. Через несколько недель один из родителей сообщил, что страница с оценками открылась с ошибкой и на экране появились какой-то код и строки, похожие на пароли. Это был доброжелательный человек, но ту же страницу мог увидеть и автоматический сканер. В такой ситуации недостаточно просто выключить отладку — нужно сменить все секреты, как описано ниже.

Как проверить, включена ли отладка на вашем сайте

Самый надёжный способ — проверить на самом сервере. В новых версиях Laravel команда about показывает окружение и состояние отладки:

php artisan about --only=environment
php artisan tinker --execute="var_dump(config('app.debug'));"
grep -E "^APP_(ENV|DEBUG)=" .env

Вторая команда показывает, с каким значением приложение работает фактически, третья — что записано в файле .env. Эти результаты могут различаться, и это не случайность: к этому приводит ловушка с кешем, описанная в следующем разделе. Полезно проверить и снаружи: в некоторых версиях с установленным Ignition адрес /_ignition/health-check отвечает в режиме отладки. Если он не возвращает 404, сразу проверьте сервер.

Правильное отключение и ловушка config:cache

В файле .env на боевом сервере обе строки должны выглядеть так:

APP_ENV=production
APP_DEBUG=false

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

php artisan config:clear
php artisan config:cache
php artisan about --only=environment

Обязательно проверьте результат последней командой. После отключения отладки пользователи при ошибке увидят обычную страницу «Server Error», а подробности будут записаны в журнал в папке storage/logs. Чтобы узнавать об ошибках быстрее, помимо журнала можно подключить сервис отслеживания ошибок — только настройте его так, чтобы в отправляемых данных не было паролей и персональных данных.

Если отладка была открыта: устраняем последствия

Если сайт был публично доступен в режиме отладки, правильно исходить из того, что секреты уже могут быть у кого-то. После отключения отладки выполните по порядку:

  1. Смените пароль пользователя базы данных и запишите новый в .env.
  2. Обновите API-ключи почты, SMS, платёжной системы и других внешних сервисов в их кабинетах.
  3. Рассмотрите смену APP_KEY; это сбросит все сессии и затронет данные, зашифрованные старым ключом.
  4. Поищите подозрительные запросы в журналах доступа.
grep "_ignition" /var/log/nginx/access.log
grep -c " 500 " /var/log/nginx/access.log

Расположение журналов зависит от хостинга; на хостинге sayt.uz их можно посмотреть через панель ISPmanager. Обращения к адресам _ignition или большое число ответов 500 за короткое время говорят о том, что кто-то целенаправленно проверял сайт. В таком случае проверьте и базу данных на новые учётные записи администраторов или изменённые записи.

Чтобы ошибка не повторилась

Лучшая защита — устранить эту ошибку на уровне процесса. Храните .env для боевого сервера отдельно и никогда не копируйте его с локальной копии. Добавьте в скрипт развёртывания шаг, проверяющий состояние отладки: если APP_DEBUG истинно, развёртывание должно остановиться. Если нужна временная диагностика, вместо включения отладки читайте журнал или используйте тестовую копию приложения.

Похожие статьи

📱 Взлом через .htaccess: мобильных посетителей перебрасывает на чужой сайт 🚪 Как найти бэкдор в WordPress: 10 явных признаков и команды для проверки 🛡️ Защита сайта на DLE: лицензия, админ-панель и папка uploads 🖱️ Clickjacking: защита сайта с помощью X-Frame-Options и CSP
🌐 Язык
🇺🇿 O'zbek 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English