UploadedFile

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

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

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

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

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

Параметры

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

Исключения

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, если файл был загружен успешно через HTTP и без ошибок.

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

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

static int getMaxFilesize()

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

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

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

string getErrorMessage()

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

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

string

Сообщение об ошибке для указанного кода ошибки