VOOZH about

URL: https://api.nette.org/http/master/Nette/Http/FileUpload.html

⇱ Nette\Http\FileUpload | Nette Http API

  1. class
  2. Nette
  3. \
  4. Http
  5. \
  6. FileUpload

FileUpload

final class FileUpload

Provides access to individual files that have been uploaded by a client.

Constants

IMAGE_MIME_TYPES

Properties

string read-only $name
string read-only $sanitizedName
string read-only $untrustedFullPath
?string read-only $contentType
int read-only $size
string read-only $temporaryFile
int read-only $error
bool read-only $ok
?string read-only $contents

Methods

__construct(array|string|null $value)

No description

string
getName()

No description

string
getUntrustedName()

Returns the original file name as submitted by the browser. Do not trust the value returned by this method.

string
getSanitizedName()

Returns the sanitized file name. The resulting name contains only ASCII characters [a-zA-Z0-9.-].

string
getUntrustedFullPath()

Returns the original full path as submitted by the browser during directory upload. Do not trust the value returned by this method. A client could send a malicious directory structure with the intention to corrupt or hack your application.

string|null
getContentType()

Detects the MIME content type of the uploaded file based on its signature. Requires PHP extension fileinfo.

string|null
getSuggestedExtension()

Returns the appropriate file extension (without the period) corresponding to the detected MIME type. Requires the PHP extension fileinfo.

int
getSize()

Returns the size of the uploaded file in bytes.

string
getTemporaryFile()

Returns the path of the temporary location of the uploaded file.

string
__toString()

Returns the path of the temporary location of the uploaded file.

int
getError()

Returns the upload error code (one of the UPLOAD_ERR_XXX constants).

bool
isOk()

Returns true if the file was uploaded successfully.

bool
hasFile()

Returns true if the user has uploaded a file.

move(string $dest)

Moves an uploaded file to a new location. If the destination file already exists, it will be overwritten.

bool
isImage()

Checks whether the uploaded file is an image in a format supported by PHP (detectable via fileinfo, loadable via GD).

Image
toImage()

Converts uploaded image to Nette\Utils\Image object.

array|null
getImageSize()

Returns the [width, height] dimensions of the uploaded image, or null if it is not a valid image.

string|null
getImageFileExtension() deprecated

Returns image file extension based on detected content type (without dot).

string|null
getContents()

Returns the contents of the uploaded file. If the upload was not successful, it returns null.

Details

at line 45
__construct(array|string|null $value)

No description

Parameters

array|string|null $value

at line 65
string getName()

No description

Return Value

string

at line 77
string getUntrustedName()

Returns the original file name as submitted by the browser. Do not trust the value returned by this method.

A client could send a malicious filename with the intention to corrupt or hack your application.

Return Value

string

at line 88
string getSanitizedName()

Returns the sanitized file name. The resulting name contains only ASCII characters [a-zA-Z0-9.-].

If the name does not contain such characters, it returns 'unknown'. If the file is an image supported by PHP, it returns the correct file extension. Do not blindly trust the value returned by this method.

Return Value

string

at line 108
string getUntrustedFullPath()

Returns the original full path as submitted by the browser during directory upload. Do not trust the value returned by this method. A client could send a malicious directory structure with the intention to corrupt or hack your application.

Return Value

string

at line 118
string|null getContentType()

Detects the MIME content type of the uploaded file based on its signature. Requires PHP extension fileinfo.

If the upload was not successful or the detection failed, it returns null.

Return Value

string|null

at line 131
string|null getSuggestedExtension()

Returns the appropriate file extension (without the period) corresponding to the detected MIME type. Requires the PHP extension fileinfo.

Return Value

string|null

at line 153
int getSize()

Returns the size of the uploaded file in bytes.

Return Value

int

at line 162
string getTemporaryFile()

Returns the path of the temporary location of the uploaded file.

Return Value

string

at line 171
string __toString()

Returns the path of the temporary location of the uploaded file.

Return Value

string

at line 181
int getError()

Returns the upload error code (one of the UPLOAD_ERR_XXX constants).

at line 190
bool isOk()

Returns true if the file was uploaded successfully.

Return Value

bool

at line 199
bool hasFile()

Returns true if the user has uploaded a file.

Return Value

bool

at line 208
FileUpload move(string $dest)

Moves an uploaded file to a new location. If the destination file already exists, it will be overwritten.

Parameters

string $dest

Return Value

FileUpload

at line 230
bool isImage()

Checks whether the uploaded file is an image in a format supported by PHP (detectable via fileinfo, loadable via GD).

Detection is based on file signature; full integrity is not verified.

Return Value

bool

at line 241
Image toImage()

Converts uploaded image to Nette\Utils\Image object.

Return Value

Image

Exceptions

ImageException

at line 251
array|null getImageSize()

Returns the [width, height] dimensions of the uploaded image, or null if it is not a valid image.

Return Value

array|null

at line 263
string|null getImageFileExtension() deprecated

deprecated use getSuggestedExtension()

Returns image file extension based on detected content type (without dot).

Return Value

string|null

at line 272
string|null getContents()

Returns the contents of the uploaded file. If the upload was not successful, it returns null.

Return Value

string|null

Traits

SmartObject