Laravel: Please provide a valid cache path — нет папок в storage
Laravel хранит готовые шаблоны страниц, кеш и сессии в папке storage/framework, а свой служебный кеш — в bootstrap/cache. Если нужной папки нет или в неё нельзя писать, Laravel не запускается. Папки создаются одной командой, права — второй.
Содержание 10
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Создайте недостающие папки:
mkdir -p storage/framework/cache/data storage/framework/sessions storage/framework/views storage/logs bootstrap/cache- Отдайте их пользователю сайта:
sudo chown -R www-data:www-data storage bootstrap/cache. - Обновите страницу сайта.
Команды вводятся на сервере: подключитесь к нему по 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 |
| владелец — root | sudo 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.
Источники
- Документация Laravel: Deployment — на английском: право на запись в storage и bootstrap/cache.
- Документация Laravel: Directory Structure — на английском: что лежит в storage и bootstrap/cache.
- Исходный код Compiler в Laravel 13.42.0 — на английском: текст Please provide a valid cache path.
- Исходный код PackageManifest в Laravel 13.42.0 — на английском: текст directory must be present and writable.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- Права на файлы сайтакакие права ставить файлам и папкам.
- Laravel: laravel.log could not be openedесли Laravel не пишет журнал.