Поиск
Ошибки

Laravel: laravel.log could not be opened in append mode — Laravel не может записать журнал

Laravel записывает ошибки в файл storage/logs/laravel.log. Эта ошибка значит, что открыть файл для записи не получилось: у пользователя, от которого работает сайт, нет прав на файл или на папку. Исправляется одной командой — нужно отдать папки storage и bootstrap/cache пользователю сайта.

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

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

  1. Перейдите в папку проекта: cd /var/www/example.com — вместо example.com ваша папка.
  2. Посмотрите, кому принадлежит файл журнала: ls -l storage/logs/.
  3. Отдайте папки пользователю сайта: sudo chown -R www-data:www-data storage bootstrap/cache.
  4. Обновите страницу сайта в браузере.

Команды вводятся на сервере: подключитесь к нему по 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.

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

  1. Команды artisan, которые пишут в storage, запускайте от www-data, а не через sudo:
sudo -u www-data php artisan optimize
  1. Задание планировщика 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.

  1. Если очереди запускаются через 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 modelaravel.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.

Источники

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

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

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