Класс: UploadedFile¶

Краткое содержание:¶

Обёртка над элементом $_FILES для multipart-загрузок: валидация, проверка расширения, перенос во временный/целевой путь.

Свойства¶

Нет публичных свойств.

Методы¶

public static fromFilesKey()
public originalName()
public tmpName()
public size()
public mime()
public toArray()
public assertExtension()
public moveTo()

Подробности¶

Путь: devcraft/src/classes/Http/UploadedFile.php
Namespace: DevCraft\Core\Http

Детали¶

Методы¶

fromFilesKey()¶

Создаёт экземпляр из ключа $_FILES. Бросает RuntimeException, если файл не передан, код ошибки загрузки не UPLOAD_ERR_OK или временный файл недоступен.

Параметры: - $key — Имя поля в $_FILES (например file).

Возвращает: self

originalName()¶

Возвращает: string — исходное имя файла (basename).

tmpName()¶

Возвращает: string — путь к временному файлу PHP.

size()¶

Возвращает: int — размер в байтах.

mime()¶

Возвращает: string — MIME из $_FILES['type'] (не доверять слепо).

toArray()¶

Возвращает: array — сырой элемент $_FILES.

assertExtension()¶

Проверяет расширение (без точки, нижний регистр) против белого списка.

Параметры: - $allowed — list<string>, например ['jpg', 'png', 'webp'].

moveTo()¶

Создаёт каталог при необходимости и вызывает move_uploaded_file.

Параметры: - $targetPath — абсолютный путь назначения.

Пример handler¶

PHP
use DevCraft\Core\Http\UploadedFile;
use DevCraft\Core\Http\JsonResponse;

$uploaded = UploadedFile::fromFilesKey('file');
$uploaded->assertExtension(['jpg', 'png', 'gif', 'webp']);
$uploaded->moveTo($targetDir . '/' . $storedName);

return JsonResponse::ok(['id' => $id]);

Клиент: DevCraft.Ajax.postMultipart(url, formData, onProgress?) — см. Шаблоны фронтенда.