Журналы Laravel на сервере: где laravel.log и как его читать
Когда сайт на Laravel отвечает ошибкой 500, посетитель видит только «Server Error», а причина записана в журнале — файле storage/logs/laravel.log в папке проекта. В новом проекте все ошибки пишутся в один файл, и он растёт без предела. Ниже — как найти в журнале нужную ошибку, как разбить журнал по дням и как освободить место.
Содержание 11
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Посмотрите последние строки журнала:
tail -n 50 storage/logs/laravel.log. - Найдите последние ошибки:
grep 'production.ERROR' storage/logs/laravel.log | tail -n 3 | cut -c1-300. - Чтобы журнал не рос без предела, включите отдельный файл на каждый день.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com.
Где журнал
| Что | Где |
|---|---|
| журнал Laravel | storage/logs/laravel.log в папке проекта |
| журнал по дням | storage/logs/laravel-2026-11-13.log — как включить |
| вывод воркеров очереди | файл из строки stdout_logfile в настройках Supervisor — Очереди и Supervisor |
| журнал ошибок nginx | /var/log/nginx/error.log |
Если в laravel.log пусто, а сайт отвечает ошибкой, причина до Laravel не дошла — смотрите журнал nginx: sudo tail -n 20 /var/log/nginx/error.log.
Как читать журнал
cd /var/www/example.com
tail -n 50 storage/logs/laravel.logКоманда покажет 50 последних строк. Следить за журналом вживую — новые строки будут появляться сами:
tail -f storage/logs/laravel.logОткройте сайт в браузере, повторите ошибку и смотрите, что появится. Выход — Ctrl+C. Подробнее о командах — cat, less и tail.
Найти только ошибки:
grep 'production.ERROR' storage/logs/laravel.log | tail -n 3 | cut -c1-300cut -c1-300 обрезает длинные строки до 300 знаков — в журнале строка ошибки вместе с её контекстом бывает очень длинной.
Из чего состоит строка
[2026-11-13 10:00:00] production.ERROR: No application encryption key has been specified.| Часть | Что значит |
|---|---|
[2026-11-13 10:00:00] | дата и время по часовому поясу приложения — в новом проекте UTC, на 3 часа меньше московского |
production | значение APP_ENV |
ERROR | уровень сообщения |
| текст после двоеточия | что произошло |
После текста идут подробности: файл, номер строки и список вызовов — строки, которые начинаются с #0, #1 и дальше. Причину ищите в первой строке, а не в последней. Что значат тексты — Ошибки Laravel.
Отдельный файл на каждый день
В новом проекте в .env стоит LOG_STACK=single — все записи идут в один файл. Поменяйте на daily:
LOG_STACK=daily
LOG_DAILY_DAYS=14| Строка | Что значит |
|---|---|
LOG_STACK=daily | новый файл на каждый день: laravel-2026-11-13.log |
LOG_DAILY_DAYS=14 | хранить 14 последних файлов, старые удалять; 14 — по умолчанию |
Соберите кеш настроек: sudo -u www-data php artisan config:cache. С этой минуты Laravel пишет в файл с сегодняшней датой, а старый laravel.log больше не растёт — его можно удалить.
Смотреть сегодняшний журнал:
ls storage/logs
tail -n 50 storage/logs/laravel-$(date +%F).log$(date +%F) подставляет сегодняшнюю дату в виде 2026-11-13. Дату в имени файла Laravel берёт по часовому поясу приложения: с UTC новый файл появляется в 03:00 по Москве.
Есть ещё LOG_STACK=monthly — файл на месяц, laravel-2026-11.log, хранятся 3 последних.
Какие сообщения записывать
Строка LOG_LEVEL задаёт, с какого уровня сообщения попадают в журнал. В новом проекте — debug, то есть всё.
| Уровень | Что это |
|---|---|
debug | отладочные сообщения |
info | сведения о работе |
notice | заметные события |
warning | предупреждения |
error | ошибки |
critical | серьёзные ошибки |
alert | нужна срочная реакция |
emergency | сайт не работает |
Уровни идут от младшего к старшему. Если поставить LOG_LEVEL=warning, в журнал попадут предупреждения и всё, что выше, а отладочные сообщения — нет. Журнал станет меньше, ошибки останутся. После правки — sudo -u www-data php artisan config:cache.
Если журнал занял диск
Сколько занимают журналы:
du -sh /var/www/example.com/storage/logsОчистить журнал, не удаляя сам файл:
sudo truncate -s 0 /var/www/example.com/storage/logs/laravel.logФайл останется на месте с прежним владельцем, Laravel продолжит в него писать. Чтобы место не кончилось снова, включите журнал по дням — Laravel сам будет удалять старые файлы. Если журнал нужен в одном файле, его может сжимать и удалять logrotate — logrotate. Если место кончилось совсем — No space left on device.
Права на журнал
Laravel пишет журнал от того пользователя, от которого работает: сайт — от www-data, команды artisan — от того, кто их запустил. Если журнал или файл за новый день создал другой пользователь, сайт не сможет в него писать и ответит ошибкой 500.
Поэтому команды artisan на сервере запускайте через sudo -u www-data, а строку планировщика держите в расписании cron пользователя www-data — Планировщик Laravel. Как вернуть права — laravel.log could not be opened.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
| сайт отвечает Server Error, laravel.log пуст | ошибка случилась до Laravel | sudo tail -n 20 /var/log/nginx/error.log и Разбор 500 |
laravel.log could not be opened | журнал создал другой пользователь | Разбор |
| время в журнале на 3 часа меньше московского | в config/app.php стоит 'timezone' => 'UTC' | так и задумано: при поиске по времени прибавляйте 3 часа |
| поставили daily, а пишется в laravel.log | в кеше настроек старые значения | sudo -u www-data php artisan config:cache |
| журнал на несколько гигабайт | пишется всё с уровня debug в один файл | включите daily и поднимите LOG_LEVEL |
| в журнале нет ошибок, хотя они были | LOG_LEVEL выше уровня ошибки | поставьте LOG_LEVEL=error или ниже и соберите кеш настроек |
Тексты сообщений сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Logging — на английском: каналы single, daily и monthly, LOG_DAILY_DAYS и уровни сообщений.
- Шаблон config/logging.php — на английском: LOG_STACK, LOG_LEVEL, 14 дней для daily и 3 файла для monthly.
- Исходный код LogManager в Laravel 13.42.0 — на английском: формат даты в строке журнала.
- Исходный код RotatingFileHandler в Monolog — на английском: имена файлов по дням и месяцам.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- Ошибки Laravelчто значат тексты из журнала.
- php artisan aboutсводка о проекте одной командой.