Поиск
Ошибки

Laravel: Please provide a valid cache path — нет папок в storage

Laravel хранит готовые шаблоны страниц, кеш и сессии в папке storage/framework, а свой служебный кеш — в bootstrap/cache. Если нужной папки нет или в неё нельзя писать, Laravel не запускается. Папки создаются одной командой, права — второй.

≈ 5 мин чтения
Содержание 10

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

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Создайте недостающие папки:
mkdir -p storage/framework/cache/data storage/framework/sessions storage/framework/views storage/logs bootstrap/cache
  1. Отдайте их пользователю сайта: sudo chown -R www-data:www-data storage bootstrap/cache.
  2. Обновите страницу сайта.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для Ubuntu, где сайт работает от пользователя www-data. В папке проекта лежат файл artisan и папки public и storage.

Как выглядит ошибка

Please provide a valid cache path.

Ошибку видно в терминале после php artisan … или composer install, а на сайте — с APP_DEBUG=true в файле .env. С APP_DEBUG=false посетитель видит 500 и Server Error.

Laravel не нашёл папку storage/framework/views. В неё он складывает шаблоны Blade, переведённые в код PHP. Без этой папки не откроется ни одна страница, собранная из шаблона.

Почему так бывает

В новом проекте Laravel все папки storage на месте. В Git пустые папки не хранятся, поэтому в каждой лежит маленький файл .gitignore — он и держит папку в репозитории.

Папки пропадают, если:

  • проект загрузили архивом или через FTP, а пустые папки или файлы .gitignore не попали;
  • папку storage скопировали не целиком;
  • кто-то очистил storage командой rm -rf storage/*.

Какие папки нужны

ПапкаЧто в ней
storage/framework/viewsшаблоны страниц, готовые к выполнению
storage/framework/cache/dataкеш, если в .env CACHE_STORE=file
storage/framework/sessionsсессии посетителей, если в .env SESSION_DRIVER=file
storage/logsжурнал laravel.log
storage/app/publicфайлы, которые загружают посетители
bootstrap/cacheслужебный кеш Laravel: список пакетов, настроек и маршрутов

Создать все одной командой:

mkdir -p storage/framework/cache/data storage/framework/sessions storage/framework/views storage/logs storage/app/public bootstrap/cache

Ключ -p создаёт папки вместе с родительскими и не выдаёт ошибку, если папка уже есть.

Как дать права

Папки создаются от того пользователя, который выполнил mkdir. Сайт работает от www-data — отдайте папки ему:

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache

Право на запись в storage и bootstrap/cache для веб-сервера требует документация Laravel. Что делают команды — в справочниках chown и chmod.

После этого обновите кеш шаблонов: php artisan view:clear.

Если пишет bootstrap/cache directory must be present and writable

The /var/www/example.com/bootstrap/cache directory must be present and writable.

Laravel хочет записать в bootstrap/cache список установленных пакетов — файл packages.php, — но папки нет или писать в неё нельзя. Ошибка появляется после composer install: Composer сам запускает php artisan package:discover.

Проверьте папку:

ls -ld bootstrap/cache
Что видитеЧто сделать
папки нетmkdir -p bootstrap/cache
владелец — rootsudo chown -R www-data:www-data bootstrap/cache

Если Composer запускаете от своего пользователя, а сайт работает от www-data, писать в папку должны оба. Добавьте себя в группу www-data и дайте группе право на запись:

sudo usermod -aG www-data $USER
sudo chmod -R g+rwX bootstrap/cache storage

Новая группа начнёт действовать после повторного входа по SSH.

Composer не запускайте через sudo — почему.

Если ошибка осталась

Путь к шаблонам задан в .env. Если в .env есть строка VIEW_COMPILED_PATH=, Laravel ищет папку по ней. Проверьте: grep '^VIEW_COMPILED_PATH' .env. Путь должен вести к существующей папке.

Настройки закешированы на другом сервере. В файле bootstrap/cache/config.php записаны полные пути. Если его перенесли с компьютера разработчика, пути ведут в чужие папки. Удалите кеш настроек:

php artisan config:clear

Ошибки и как их исправить

Что видитеПричинаЧто делать
Please provide a valid cache path.нет папки storage/framework/viewsсоздайте папки
bootstrap/cache directory must be present and writableнет папки или нет правпроверьте bootstrap/cache
laravel.log could not be opened in append modeнет прав на журналРазбор
file_put_contents(…/storage/framework/…): Failed to open streamнет прав на запись в storageдайте права
ошибка после переноса с компьютерав кеше настроек старые путиphp artisan config:clear

Тексты сообщений сверены по исходному коду Laravel 13.42.0.

Источники

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

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

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