UploadedFile

__construct(string $path, string $originalName, string|null $mimeType = null, int|null $size = null, int|null $error = null, bool $test = false)

Принимает информацию о загруженном файле, предоставленную глобальной переменной PHP $_FILES.

Объект файла создается только при успешной загрузке файла (т.е. когда метод isValid() возвращает true). В противном случае методы, которые можно вызывать у экземпляра UploadedFile:

• getClientOriginalName,
• getClientMimeType,
• isValid,
• getError.

Вызов любого другого метода у невалидного экземпляра приведет к непредсказуемому результату.

Параметры

string	$path	Путь к файлу
string	$originalName	Исходное имя файла
string|null	$mimeType	Тип файла, предоставленный PHP; по умолчанию null — application/octet-stream
int|null	$size	Размер файла
int|null	$error	Код ошибки загрузки (один из констант UPLOAD_ERR_XXX PHP); по умолчанию UPLOAD_ERR_OK
bool	$test	Включен ли тестовый режим

Исключения

FileException	Если file_uploads отключен
FileNotFoundException	Если файл не существует

string|null guessExtension()

Возвращает расширение на основе MIME-типа.

Если MIME-тип неизвестен, возвращает null.

Этот метод использует MIME-тип, полученный методом getMimeType(), для определения расширения файла.

Возвращаемое значение

string|null

Определенное расширение или null, если определить невозможно

См. также

ExtensionGuesser
getMimeType()

string|null getMimeType()

Возвращает MIME-тип файла.

MIME-тип определяется с помощью экземпляра MimeTypeGuesser, который использует finfo(), mime_content_type() и системную утилиту "file" (в указанном порядке), в зависимости от доступности.

Возвращаемое значение

string|null

Определенный MIME-тип (например, "application/pdf")

См. также

MimeTypeGuesser

File move(string $directory, string $name = null)

Перемещает файл в новое местоположение.

Параметры

string	$directory	Папка назначения
string	$name	Новое имя файла

Возвращаемое значение

File	Объект File, представляющий новый файл

Исключения

FileException

Если по какой-либо причине файл не может быть перемещен

string|null getClientOriginalName()

Возвращает исходное имя файла.

Извлекается из запроса, из которого был загружен файл. Поэтому его не следует считать безопасным значением.

Возвращаемое значение

string|null

Исходное имя

string getClientOriginalExtension()

Возвращает исходное расширение файла.

Извлекается из исходного имени загруженного файла. Поэтому его не следует считать безопасным значением.

Возвращаемое значение

string

Расширение

string|null getClientMimeType()

Возвращает MIME-тип файла.

MIME-тип клиента извлекается из запроса, из которого был загружен файл, поэтому его не следует считать безопасным.

Для получения надёжного MIME-типа используйте getMimeType() (который определяет MIME-тип по содержимому файла).

Возвращаемое значение

string|null

MIME-тип

См. также

getMimeType()

string|null guessClientExtension()

Возвращает расширение на основе MIME-типа клиента.

Если MIME-тип неизвестен, возвращает null.

Этот метод использует MIME-тип, полученный из getClientMimeType(), для определения расширения файла. Поэтому расширение, возвращаемое этим методом, не должно считаться надёжным.

Для получения надёжного расширения используйте guessExtension() (который определяет расширение на основе определённого MIME-типа файла).

Возвращаемое значение

string|null

Определённое расширение или null, если определить невозможно

См. также

guessExtension()
getClientMimeType()

int|null getClientSize()

Возвращает размер файла.

Извлекается из запроса, из которого был загружен файл. Поэтому его не следует считать безопасным значением.

Возвращаемое значение

int|null

Размер файла

int getError()

Возвращает код ошибки загрузки.

Если загрузка прошла успешно, возвращается константа UPLOAD_ERR_OK. В противном случае возвращается одна из других констант UPLOAD_ERR_XXX.

Возвращаемое значение

int	Код ошибки загрузки

bool isValid()

Возвращает, был ли файл загружен успешно.

Возвращаемое значение

bool	True, если файл был загружен успешно с помощью HTTP без ошибок

static int getMaxFilesize()

Возвращает максимальный размер загружаемого файла, заданный в php.ini.

Возвращаемое значение

int	Максимальный размер загружаемого файла в байтах

string getErrorMessage()

Возвращает информативное сообщение об ошибке загрузки.

Возвращаемое значение

string

Сообщение об ошибке, соответствующее указанному коду ошибки