Laravel — один из самых популярных PHP-фреймворков, и значительную часть работы по безопасности он делает за разработчика: проверяет запросы CSRF-токеном, отправляет запросы к базе через параметры, хеширует пароли, шифрует cookie. Тем не менее Laravel-приложения взламывают, и причина почти всегда не в самом фреймворке, а в том, как его развернули на сервере. В этой статье разберём настройки, которые обязательно нужно проверить перед выкладкой на боевой сервер.
Пример: система записи в клинику
Допустим, для частной клиники в Намангане сделали Laravel-приложение для онлайн-записи пациентов и запустили его по адресу navbat.example.uz. В приложении хранятся имена пациентов, телефоны и информация о том, к какому врачу они записаны. Разработчик перенёс проект на сервер с настройками со своего компьютера: в файле .env остался включённым режим отладки, а корнем сайта указана не папка public, а основная папка проекта. Вместе эти две ошибки означали, что любой посетитель мог увидеть пароль от базы данных. Шаги ниже предотвращают именно такую ситуацию.
Корнем сайта должна быть только папка public
В Laravel-проекте единственная папка, которую должен видеть браузер, — public. В ней лежат index.php, CSS, JavaScript и изображения. Всё остальное, включая .env, storage, vendor и config, не должно открываться из веба. Если на хостинге можно изменить корень сайта, направьте его прямо в public. В панели ISPmanager это делается через поле корневого каталога в настройках веб-домена.
/home/klinika/navbat/ # проект Laravel
/home/klinika/navbat/public/ # сюда указывает корень сайта
curl -I https://navbat.example.uz/.env
Последняя команда должна вернуть 404 или 403. Если видно содержимое файла — это проблема наивысшего уровня, и все пароли из него нужно немедленно сменить.
Что такое APP_KEY и почему его нужно хранить в секрете
APP_KEY — главный ключ шифрования Laravel. Он используется для зашифрованных cookie, сессий, данных, зашифрованных через Crypt, и подписанных ссылок. Если ключ утечёт, злоумышленник сможет подделывать cookie, сам создавать подписанные ссылки и расшифровывать защищённые поля. Известны случаи, когда в старых версиях Laravel утёкший ключ открывал путь даже к удалённому выполнению кода. Поэтому ключ никогда не должен попадать в Git-репозиторий, а для каждого окружения он должен быть своим.
php artisan key:generate --show # показывает новый ключ, не записывая в .env
php artisan key:generate # заменяет APP_KEY в .env
При смене ключа будьте осторожны: все пользователи разлогинятся, а данные, зашифрованные старым ключом, перестанут читаться. В новых версиях Laravel есть переменная APP_PREVIOUS_KEYS: если указать в ней старый ключ, приложение продолжит расшифровывать старые данные. Если ключ утёк, смена обязательна; если вы меняете его просто на всякий случай, сначала проверьте, есть ли зашифрованные столбцы.
.env и настройки боевого окружения
Файл .env на боевом сервере должен отличаться от копии на компьютере разработчика. Самые важные строки:
APP_ENV=production
APP_DEBUG=false
APP_URL=https://navbat.example.uz
LOG_LEVEL=warning
SESSION_SECURE_COOKIE=true
Если оставить APP_DEBUG=true, при ошибке Laravel покажет подробную страницу, где могут оказаться переменные окружения, пути к файлам и детали запроса. Эта тема настолько важна, что мы посвятили ей отдельную статью. После изменения настроек не забудьте обновить кеш конфигурации, иначе приложение продолжит работать со старыми значениями.
composer install --no-dev --optimize-autoloader
php artisan config:cache
php artisan route:cache
Дайте файлу .env права, позволяющие читать его только владельцу сайта, например chmod 600 .env. Папки storage и bootstrap/cache должны быть доступны для записи, но ставить 777 не нужно.
Типичные ошибки на уровне кода
Защиту фреймворка разработчик может обойти сам. Самый частый случай — mass assignment: если модель принимает все поля запроса, пользователь может дописать в форму поле вроде is_admin. Явно задавайте в модели список $fillable и используйте проверенные данные вместо $request->all().
// Опасно
Appointment::create($request->all());
// Правильно
$data = $request->validate([
'doctor_id' => 'required|exists:doctors,id',
'phone' => 'required|string|max:20',
]);
Appointment::create($data);
Второй риск — сырые SQL-запросы. Не подставляйте введённое пользователем значение напрямую в DB::raw или whereRaw, используйте плейсхолдеры параметров. Третий — вывод непроверенного текста в Blade через {!! !!}, что открывает дорогу XSS. Не ослабляйте и CSRF-защиту, добавляя лишние маршруты в исключения: исключением могут быть только запросы, действительно приходящие от внешних сервисов, например уведомления платёжной системы.
Страница входа и дополнительные пакеты
Готовые пакеты аутентификации Laravel ограничивают число попыток входа, но на собственных маршрутах входа или отправки SMS-кодов не забывайте добавлять middleware throttle. Иначе боты смогут подбирать пароли или вводить вас в расходы рассылкой SMS. Диагностические пакеты вроде Telescope или Debugbar на боевом сервере должны быть отключены или доступны только администраторам: они полностью показывают запросы, сессии и SQL.
composer audit
Эта команда проверяет установленные пакеты на известные уязвимости. Запускать её перед каждым обновлением должно войти в привычку. Где бы вы ни разместили Laravel-приложение — на хостинге sayt.uz или на VPS, — эти проверки одинаковы: каким бы хорошим ни был сервер, за настройки приложения отвечает разработчик.