по http не приходит файл
но я уже начинаю придираться к словам

возвращает он примерно это
return new File([
           'sysPath' => $newFilePath,
           'uriPath' => $uriPath,
           'name' => "$newFileName.$extension",
           'mimeType' => $mimeType,
           'size' => $file['size'],
       ]);

плюс стейт класса

Статический стейт

и self и static внутри

Ну, т. Е. Объекта не было, но когда ты сохранил, он появился

я предпочитаю термин "стейт класса"
потому что термины "динамический" и "статический" начинают путаться с "времени компиляции" vs. "в рантайме"

класса в рантайме как бы нет, но его стейт вполне есть ))

да, как-то так)

Когда у тебя в одном файле 2 стейта, путаницы ещё больше)

не очень понял, но пофигу

я ваще кино смотрю ))

как бы вы организовали простой сторедж с возможностью загружать файлы и получать на них ссылки по ид?

сторедж не занимается загрузкой файлов по http

вот и весь ответ

сделайте для начала отдельный класс
объект которого умеет что-то делать с $_FILES
например понимать - был ли файл передан, без ошибок, совпадает mime-type с ожидаемым, совпадает заявленный размер с реально сохраненным в tmp
ну и наконец умеет перемещать из временного места в постоянное и решать коллизии имен в соответствии с какой-то стратегией переименования

и вот переместив  - возвращает уже объект типа File
бинго

а дальше вы ничего уже не знаете про то, откуда файл взялся
вы видите тупо файл и всё

а вы делаете кашу из http, файлов, хранилищ, репозиториев и всего прочего

вы меня точно не так поняли)
есть апи, принимающий запросы (из браузера, ажаксом), у которого есть, скажем, 3 метода - upload, get и delete.
соответственно, при запросе на /upload и наличием файла в массиве $_FILES должна произвестись загрузка файла на сервер и сохранение названия\пути\остального в базу.
в методе апи upload производится проверка, что пришел действительно файл, после этого вызывается Manager->store($file).

внутри store() происходит примерно следующее:
/** @var File */
$uploadedFile = $this->storage->upload($file);
/* сохранение данных из $uploadedFile в базу */

внутри $this->storage->upload() идёт уже процесс создания файла:
валидация (размер, майм)
создание сабдиректорий для этого файла
сам move_uploaded_file
создание объекта File и заполнение свойств
потом этот объект возвращается

ОК, делайте так