Поиск
Ошибки

Laravel: загруженные файлы не открываются — php artisan storage:link

Файлы, которые загружают посетители, Laravel хранит в папке storage/app/public. Сайт отдаёт только то, что лежит в папке public. Чтобы файлы были видны по адресу /storage/…, в public нужна символическая ссылка storage — её создаёт команда php artisan storage:link. Если ссылки нет, картинки отвечают 404.

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

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

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Посмотрите, что такое public/storage: ls -l public/ | grep storage.
  3. Если строки нет — создайте ссылку: php artisan storage:link.
  4. Откройте адрес картинки в браузере ещё раз.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). В папке проекта лежат файл artisan и папки public и storage.

Как это устроено

ЧтоГде
файлы лежатstorage/app/public/avatars/photo.jpg
ссылкаpublic/storage → storage/app/public
адрес на сайтеhttps://example.com/storage/avatars/photo.jpg

nginx отдаёт файлы из папки public. Через ссылку public/storage он попадает в storage/app/public. Сама папка storage остаётся закрытой от посетителей.

Ссылка — это ярлык на другую папку. Подробнее — в справочнике ln.

Как создать ссылку

php artisan storage:link

Ответ:

INFO  The [/var/www/example.com/public/storage] link has been connected to [/var/www/example.com/storage/app/public].

Проверьте:

ls -l public/storage

В ответе в начале строки буква l и стрелка -> на папку storage/app/public. Значит, ссылка на месте.

В Git ссылка не хранится: строка /public/storage есть в файле .gitignore нового проекта. Поэтому после git clone на сервере команду нужно выполнить один раз.

ERROR  The [/var/www/example.com/public/storage] link already exists.

На месте ссылки что-то уже есть. Посмотрите, что именно:

ls -ld public/storage
Что в начале строкиЧто этоЧто делать
l и стрелка на storage/app/public этого проектарабочая ссылканичего — ссылка уже есть, ищите причину 404 ниже
l и стрелка на другую папкуссылка из другого места, например с компьютера разработчикаphp artisan storage:link --force
dпапка, а не ссылкаперенесите файлы

Ключ --force пересоздаёт только ссылку. Папку с файлами он не трогает.

Если ссылка ведёт в несуществующую папку, команда без --force сама удалит её и создаст заново.

Если public/storage — папка, а не ссылка

Так бывает, если проект загружали через FTP или архивом: вместо ссылки на сервер попала копия папки. Новые файлы Laravel пишет в storage/app/public, а сайт показывает старую копию — новые картинки отвечают 404.

Перенесите из копии файлы, которых нет в настоящей папке, потом уберите копию:

rsync -a --ignore-existing public/storage/ storage/app/public/
mv public/storage public/storage-old
php artisan storage:link

Ключ --ignore-existing не даёт перезаписать файлы, которые уже лежат в storage/app/public.

Проверьте, что картинки открываются. Если всё работает, удалите копию: rm -r public/storage-old.

Как работает rsync — в справочнике rsync.

Если ссылка есть, а файлы не открываются

Файл лежит не там. В новом проекте Laravel диск по умолчанию — local, его папка — storage/app/private. Файлы оттуда сайт не отдаёт. Проверьте, где файл:

find storage/app -name 'photo.jpg'

Если файл в storage/app/private, в коде загрузки укажите диск public, например $request->file('avatar')->store('avatars', 'public').

Адрес строится с чужим доменом. Laravel собирает адрес файла из строки APP_URL файла .env. Если там http://localhost, на сайте будут ссылки на localhost. Проверьте:

grep '^APP_URL=' .env

Должен стоять адрес сайта, например APP_URL=https://example.com. После правки — php artisan config:clear или снова php artisan config:cache.

Нет прав на чтение. nginx работает от www-data и должен читать файлы в storage/app/public. Проверьте права по пути целиком:

namei -l storage/app/public/avatars/photo.jpg

Как читать ответ — в справочнике namei. Если где-то нет прав — ошибка 403.

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

Что видитеПричинаЧто делать
картинки по адресу /storage/… дают 404нет ссылки public/storagephp artisan storage:link
link already exists, а файлы не открываютсяссылка ведёт в другую папкуphp artisan storage:link --force
link already exists, public/storage — папкассылку заменила копияперенесите файлы
файл есть, но в storage/app/privateзагружен на диск localукажите диск public
в адресе картинки localhostневерный APP_URLпоправьте APP_URL
403 Forbidden на картинкахnginx не может прочитать файлРазбор
404 Not Found на всех страницах, кроме главнойnginx не передаёт адреса в LaravelРазбор

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

Источники

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

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

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