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	Код ошибки загрузки (один из констант PHP UPLOAD_ERR_XXX); по умолчанию 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()

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

Значение возврата

bool	True, если файл успешно загружен через HTTP и без ошибок

static int getMaxFilesize()

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

Значение возврата

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

string getErrorMessage()

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

Значение возврата

string

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