Symfony2 API
Class

Symfony\Component\HttpFoundation\File\UploadedFile

class UploadedFile extends File

A file uploaded through a form.

Methods

__construct(string $path, string $originalName, string $mimeType = null, integer $size = null, integer $error = null, Boolean $test = false)

Accepts the information of the uploaded file as provided by the PHP global $_FILES.
string|null guessExtension()

Returns the extension based on the mime type.

 from File
string|null getMimeType()

Returns the mime type of the file.

 from File
string getExtension()

Returns the extension of the file.

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

Moves the file to a new location.
string|null getClientOriginalName()

Returns the original file name.
string getClientOriginalExtension()

Returns the original file extension
string|null getClientMimeType()

Returns the file mime type.
string|null guessClientExtension()

Returns the extension based on the client mime type.
integer|null getClientSize()

Returns the file size.
integer getError()

Returns the upload error.
Boolean isValid()

Returns whether the file was uploaded successfully.
static int getMaxFilesize()

Returns the maximum size of an uploaded file as configured in php.ini
string getErrorMessage()

Returns an informative upload error message.

Details

at line 92
public __construct(string $path, string $originalName, string $mimeType = null, integer $size = null, integer $error = null, Boolean $test = false)

Accepts the information of the uploaded file as provided by the PHP global $_FILES.

The file object is only created when the uploaded file is valid (i.e. when the isValid() method returns true). Otherwise the only methods that could be called on an UploadedFile instance are:

Calling any other method on an non-valid instance will cause an unpredictable result.

Parameters

string $path The full temporary path to the file
string $originalName The original file name
string $mimeType The type of the file as provided by PHP
integer $size The file size
integer $error The error constant of the upload (one of PHP's UPLOADERRXXX constants)
Boolean $test Whether the test mode is active

Exceptions

FileException If file_uploads is disabled
FileNotFoundException If the file does not exist

in File at line 62
public string|null guessExtension()

Returns the extension based on the mime type.

If the mime type is unknown, returns null.

This method uses the mime type as guessed by getMimeType() to guess the file extension.

Return Value

string|null The guessed extension or null if it cannot be guessed

See also

getMimeType()

in File at line 83
public string|null getMimeType()

Returns the mime type of the file.

The mime type is guessed using a MimeTypeGuesser instance, which uses finfo(), mimecontenttype() and the system binary "file" (in this order), depending on which of those are available.

Return Value

string|null The guessed mime type (i.e. "application/pdf")

See also

MimeTypeGuesser

in File at line 99
public string getExtension()

Returns the extension of the file.

\SplFileInfo::getExtension() is not available before PHP 5.3.6

Return Value

string The extension

at line 236
public File move(string $directory, string $name = null)

Moves the file to a new location.

Parameters

string $directory The destination folder
string $name The new file name

Return Value

File A File object representing the new file

Exceptions

FileException if, for any reason, the file could not have been moved

at line 117
public string|null getClientOriginalName()

Returns the original file name.

It is extracted from the request from which the file has been uploaded. Then is should not be considered as a safe value.

Return Value

string|null The original name

at line 130
public string getClientOriginalExtension()

Returns the original file extension

It is extracted from the original file name that was uploaded. Then is should not be considered as a safe value.

Return Value

string The extension

at line 150
public string|null getClientMimeType()

Returns the file mime type.

The client mime type is extracted from the request from which the file was uploaded, so it should not be considered as a safe value.

For a trusted mime type, use getMimeType() instead (which guesses the mime type based on the file content).

Return Value

string|null The mime type

See also

getMimeType

at line 172
public string|null guessClientExtension()

Returns the extension based on the client mime type.

If the mime type is unknown, returns null.

This method uses the mime type as guessed by getClientMimeType() to guess the file extension. As such, the extension returned by this method cannot be trusted.

For a trusted extension, use guessExtension() instead (which guesses the extension based on the guessed mime type for the file).

Return Value

string|null The guessed extension or null if it cannot be guessed

See also

guessExtension()
getClientMimeType()

at line 190
public integer|null getClientSize()

Returns the file size.

It is extracted from the request from which the file has been uploaded. Then is should not be considered as a safe value.

Return Value

integer|null The file size

at line 205
public integer getError()

Returns the upload error.

If the upload was successful, the constant UPLOADERROK is returned. Otherwise one of the other UPLOADERRXXX constants is returned.

Return Value

integer The upload error

at line 217
public Boolean isValid()

Returns whether the file was uploaded successfully.

Return Value

Boolean True if the file has been uploaded with HTTP and no error occurred.

at line 263
static public int getMaxFilesize()

Returns the maximum size of an uploaded file as configured in php.ini

Return Value

int The maximum size of an uploaded file in bytes

at line 286
public string getErrorMessage()

Returns an informative upload error message.

Return Value

string The error message regarding the specified error code