Поиск
Справочник

Журналы Laravel на сервере: где laravel.log и как его читать

Когда сайт на Laravel отвечает ошибкой 500, посетитель видит только «Server Error», а причина записана в журнале — файле storage/logs/laravel.log в папке проекта. В новом проекте все ошибки пишутся в один файл, и он растёт без предела. Ниже — как найти в журнале нужную ошибку, как разбить журнал по дням и как освободить место.

≈ 6 мин чтения
Содержание 11

Что сделать прямо сейчас

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Посмотрите последние строки журнала: tail -n 50 storage/logs/laravel.log.
  3. Найдите последние ошибки: grep 'production.ERROR' storage/logs/laravel.log | tail -n 3 | cut -c1-300.
  4. Чтобы журнал не рос без предела, включите отдельный файл на каждый день.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com.

Где журнал

ЧтоГде
журнал Laravelstorage/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-300

cut -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 пустошибка случилась до Laravelsudo 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.

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше