Laravel: laravel.log could not be opened in append mode — Laravel не может записать журнал
Laravel записывает ошибки в файл storage/logs/laravel.log. Эта ошибка значит, что открыть файл для записи не получилось: у пользователя, от которого работает сайт, нет прав на файл или на папку. Исправляется одной командой — нужно отдать папки storage и bootstrap/cache пользователю сайта.
Содержание 11
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com— вместо example.com ваша папка. - Посмотрите, кому принадлежит файл журнала:
ls -l storage/logs/. - Отдайте папки пользователю сайта:
sudo chown -R www-data:www-data storage bootstrap/cache. - Обновите страницу сайта в браузере.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04: в нём сайт работает от пользователя www-data. В папке проекта лежат файл artisan и папки public и storage.
Как выглядит ошибка
The stream or file "/var/www/example.com/storage/logs/laravel.log" could not be opened in append mode: Failed to open stream: …
The exception occurred while attempting to log: …| Часть | Что значит |
|---|---|
The stream or file "…/laravel.log" | файл журнала Laravel |
could not be opened in append mode | «не открылся для дописывания в конец» |
Failed to open stream: … | причину сообщила система: после двоеточия — нет прав или нет папки |
The exception occurred while attempting to log: … | какую запись Laravel пытался записать в журнал |
Где видна ошибка:
- в браузере — текст ошибки, если в файле
.envстоитAPP_DEBUG=true; - в браузере — страница
500иServer Error, еслиAPP_DEBUG=false; - в терминале — после команды
php artisan ….
В самом laravel.log этой записи нет: в него как раз не получилось написать.
Почему так бывает
Сайт на Laravel выполняет PHP-FPM. В Ubuntu он работает от пользователя www-data. Laravel пишет в журнал от этого же пользователя.
Файл laravel.log создаёт тот, кто первым записал в журнал. Если первой была команда sudo php artisan … или задание cron от root, файл принадлежит root. Права у нового файла — -rw-r--r--: писать может только владелец. Пользователь www-data файл прочитает, но дописать в него не сможет.
Если в журнал пишет канал daily, Laravel каждый день заводит новый файл, например laravel-2026-11-13.log. Тогда ошибка начинается в тот день, когда первым после полуночи в журнал записало задание от root.
Вторая причина — папка storage/logs принадлежит другому пользователю, и www-data не может создать в ней файл.
Как проверить
Посмотрите владельцев файлов в папке журнала:
ls -l storage/logs/Ответ выглядит так:
-rw-r--r-- 1 root root 48213 Nov 13 10:00 laravel.logТретья колонка — владелец файла, четвёртая — группа. Если там root, причина найдена.
От какого пользователя работает PHP-FPM, покажет файл пула:
grep -E '^(user|group) =' /etc/php/8.3/fpm/pool.d/www.confВ ответе user = www-data и group = www-data.
Как исправить
Отдайте пользователю сайта две папки, в которые Laravel пишет, — storage и bootstrap/cache. Так советует документация Laravel: веб-сервер должен иметь право писать в эти папки.
cd /var/www/example.com
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache| Команда | Что делает |
|---|---|
sudo chown -R www-data:www-data storage bootstrap/cache | владелец папок и всех файлов в них — www-data |
sudo chmod -R ug+rwX storage bootstrap/cache | владелец и группа могут читать и писать, папки можно открыть |
Подробнее о командах — в справочниках chown и chmod. Права на остальные файлы сайта — в статье Права на файлы сайта.
Обновите страницу. Проверьте, что запись в журнал идёт: tail -n 5 storage/logs/laravel.log.
Чтобы ошибка не вернулась
- Команды artisan, которые пишут в storage, запускайте от www-data, а не через
sudo:
sudo -u www-data php artisan optimize- Задание планировщика Laravel поставьте в cron пользователя www-data. Откройте его расписание:
sudo crontab -u www-data -eи добавьте строку из документации Laravel, указав свою папку:
* * * * * cd /var/www/example.com && php artisan schedule:run >> /dev/null 2>&1Если эта строка уже есть в расписании root — посмотрите его командой sudo crontab -l, — удалите её оттуда. Как устроен cron — в справочнике cron.
- Если очереди запускаются через Supervisor, в настройках программы укажите
user=www-data. Как настроить Supervisor — в статье Установка Supervisor.
Если хотите оставить файлы своему пользователю
Можно сделать так, чтобы журнал могли дописывать и вы, и www-data. Для этого вас добавляют в группу www-data, а у файлов журнала ставят права 0664 — запись для группы. Права задаёт настройка permission канала в файле config/logging.php:
'single' => [
'driver' => 'single',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
'replace_placeholders' => true,
'permission' => 0664,
],Без этой строки права у новых файлов журнала — 0644, так написано в документации Laravel. Та же настройка есть у канала daily. Если настройки закешированы командой config:cache, после правки выполните её снова.
Если пишет There is no existing directory
There is no existing directory at "/var/www/example.com/storage/logs" and it could not be created: …Папки storage/logs нет, и создать её не получилось. Так бывает, если проект загрузили на сервер без папки storage. Создайте папку и отдайте её пользователю сайта:
mkdir -p storage/logs
sudo chown -R www-data:www-data storageЕсли не хватает и других папок storage, Laravel покажет Please provide a valid cache path. — разбор этой ошибки.
Если пишет Writing to the log file failed
Writing to the log file failed: …Файл открылся, но дописать в него не получилось. Проверьте место на диске: df -h. Если в колонке Use% у раздела стоит 100%, освободите место — как найти, что его заняло, рассказано в справочнике df и du.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
could not be opened in append mode | laravel.log принадлежит root или другому пользователю | отдайте папки www-data |
| ошибка вернулась на следующий день | новый файл канала daily создало задание от root | перенесите cron к www-data |
There is no existing directory at | нет папки storage/logs | создайте папку |
Writing to the log file failed | файл не дописывается, проверьте место на диске | разбор |
Please provide a valid cache path. | нет папки storage/framework/views | Разбор |
bootstrap/cache directory must be present and writable | нет записи в bootstrap/cache | Разбор |
Тексты сообщений сверены по исходному коду Laravel 13.42.0 и библиотеки журнала Monolog, которой пользуется Laravel.
Источники
- Документация Laravel: Logging — на английском: каналы single и daily, настройки permission и locking.
- Документация Laravel: Deployment — на английском: право на запись в storage и bootstrap/cache.
- Документация Laravel: Task Scheduling — на английском: строка cron для schedule:run.
- Исходный код StreamHandler в Monolog — на английском: тексты could not be opened in append mode и There is no existing directory, права 0644 по умолчанию.
- Шаблон config/logging.php в Laravel — на английском: путь storage/logs/laravel.log.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- PHP: Failed to open streamта же причина в коде PHP без Laravel.
- Права на файлы сайтакакие права ставить файлам и папкам.