Properties

$errors

$errors : array<mixed,integer>

Type

array<mixed,integer>

$clientFilename

$clientFilename : string

Type

string

$clientMediaType

$clientMediaType : string

Type

string

$error

$error : integer

Type

integer

$file

$file : null|string

Type

null|string

$moved

$moved : boolean

Type

boolean

$size

$size : integer

Type

integer

Methods

__construct()

__construct(\Psr\Http\Message\StreamInterface|string|resource  $streamOrFile, integer  $size, integer  $errorStatus, string|null  $clientFilename = null, string|null  $clientMediaType = null) 

Parameters

\Psr\Http\Message\StreamInterface|string|resource $streamOrFile
integer $size
integer $errorStatus
string|null $clientFilename
string|null $clientMediaType

isMoved()

isMoved() : boolean

Returns

boolean

getStream()

getStream() : \Psr\Http\Message\StreamInterface

Retrieve a stream representing the uploaded file.

This method MUST return a StreamInterface instance, representing the uploaded file. The purpose of this method is to allow utilizing native PHP stream functionality to manipulate the file upload, such as stream_copy_to_stream() (though the result will need to be decorated in a native PHP stream wrapper to work with such functions).

If the moveTo() method has been called previously, this method MUST raise an exception.

Throws

\RuntimeException

if the upload was not successful.

Returns

\Psr\Http\Message\StreamInterface

Stream representation of the uploaded file.

moveTo()

moveTo(string  $targetPath) 

Move the uploaded file to a new location.

Use this method as an alternative to move_uploaded_file(). This method is guaranteed to work in both SAPI and non-SAPI environments. Implementations must determine which environment they are in, and use the appropriate method (move_uploaded_file(), rename(), or a stream operation) to perform the operation.

$targetPath may be an absolute path, or a relative path. If it is a relative path, resolution should be the same as used by PHP's rename() function.

The original file or stream MUST be removed on completion.

If this method is called more than once, any subsequent calls MUST raise an exception.

When used in an SAPI environment where $_FILES is populated, when writing files via moveTo(), is_uploaded_file() and move_uploaded_file() SHOULD be used to ensure permissions and upload status are verified correctly.

If you wish to move to a stream, use getStream(), as SAPI operations cannot guarantee writing to stream destinations.

Parameters

string $targetPath

Path to which to move the uploaded file.

Throws

\RuntimeException

if the upload was not successful.

\InvalidArgumentException

if the $path specified is invalid.

\RuntimeException

on any error during the move operation, or on the second or subsequent call to the method.

getSize()

getSize() : integer|null

Retrieve the file size.

Implementations SHOULD return the value stored in the "size" key of the file in the $_FILES array if available, as PHP calculates this based on the actual size transmitted.

Returns

integer|null —

The file size in bytes or null if unknown.

getError()

getError() : integer

Retrieve the error associated with the uploaded file.

The return value MUST be one of PHP's UPLOAD_ERR_XXX constants.

If the file was uploaded successfully, this method MUST return UPLOAD_ERR_OK.

Implementations SHOULD return the value stored in the "error" key of the file in the $_FILES array.

Returns

integer —

One of PHP's UPLOAD_ERR_XXX constants.

getClientFilename()

getClientFilename() : string|null

Retrieve the filename sent by the client.

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.

Implementations SHOULD return the value stored in the "name" key of the file in the $_FILES array.

Returns

string|null —

The filename sent by the client or null if none was provided.

getClientMediaType()

getClientMediaType() : string|null

Retrieve the media type sent by the client.

Do not trust the value returned by this method. A client could send a malicious media type with the intention to corrupt or hack your application.

Implementations SHOULD return the value stored in the "type" key of the file in the $_FILES array.

Returns

string|null —

The media type sent by the client or null if none was provided.

setStreamOrFile()

setStreamOrFile(mixed  $streamOrFile) 

Depending on the value set file or stream variable

Parameters

mixed $streamOrFile

Throws

\InvalidArgumentException

setError()

setError(integer  $error) 

Parameters

integer $error

Throws

\InvalidArgumentException

setSize()

setSize(integer  $size) 

Parameters

integer $size

Throws

\InvalidArgumentException

isStringOrNull()

isStringOrNull(mixed  $param) : boolean

Parameters

mixed $param

Returns

boolean

isStringNotEmpty()

isStringNotEmpty(mixed  $param) : boolean

Parameters

mixed $param

Returns

boolean

setClientFilename()

setClientFilename(string|null  $clientFilename) 

Parameters

string|null $clientFilename

Throws

\InvalidArgumentException

setClientMediaType()

setClientMediaType(string|null  $clientMediaType) 

Parameters

string|null $clientMediaType

Throws

\InvalidArgumentException

isOk()

isOk() : boolean

Return true if there is no upload error

Returns

boolean

validateActive()

validateActive() 

Throws

\RuntimeException

if is moved or not ok