Laravel: загруженные файлы не открываются — php artisan storage:link
Файлы, которые загружают посетители, Laravel хранит в папке storage/app/public. Сайт отдаёт только то, что лежит в папке public. Чтобы файлы были видны по адресу /storage/…, в public нужна символическая ссылка storage — её создаёт команда php artisan storage:link. Если ссылки нет, картинки отвечают 404.
Содержание 9
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Посмотрите, что такое
public/storage:ls -l public/ | grep storage. - Если строки нет — создайте ссылку:
php artisan storage:link. - Откройте адрес картинки в браузере ещё раз.
Команды вводятся на сервере: подключитесь к нему по 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 на сервере команду нужно выполнить один раз.
Если пишет link already exists
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/storage | php 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.
Источники
- Документация Laravel: File Storage — на английском: диск public, команда storage:link и настройка links.
- Исходный код команды storage:link в Laravel 13.42.0 — на английском: тексты link already exists и has been connected, ключ --force.
- Шаблон config/filesystems.php в Laravel — на английском: диски local и public, адрес из APP_URL.
- Файл .gitignore нового проекта Laravel — на английском: строка /public/storage.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- Команда lnчто такое символическая ссылка.
- Права на файлы сайтакакие права ставить файлам и папкам.