You are here
Symfony\Component\HttpFoundation\File\UploadedFile 有大用
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 |
Details
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:
- getClientOriginalName,
- getClientMimeType,
- isValid,
- getError.
Calling any other method on an non-valid instance will cause an unpredictable result.
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.
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.
public string getExtension()Returns the extension of the file.
\SplFileInfo::getExtension() is not available before PHP 5.3.6
public File move(string $directory, string $name = null)Moves the file to a new location.
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.
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.
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).
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).
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.
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.
public Boolean isValid()Returns whether the file was uploaded successfully.
static public int getMaxFilesize()Returns the maximum size of an uploaded file as configured in php.ini