Référence de la classe UploadedFile

Graphe d'héritage de UploadedFile:

Fonctions membres publiques
	__construct ( $streamOrFile, int $size, int $errorStatus, string $clientFilename=null, string $clientMediaType=null)
	getStream ()
	moveTo ($targetPath)
	getSize ()
	getError ()
	getClientFilename ()
	getClientMediaType ()

Champs de données
const	ERROR_MESSAGES
const	UPLOAD_ERR_INI_SIZE

Fonctions membres privées
	writeFile (string $path)

Attributs privés
	$clientFilename
	$clientMediaType
	$error
	$file
	$moved = false
	$size
	$stream

Documentation des constructeurs et destructeur

__construct()

__construct	(		$streamOrFile,
		int	$size,
		int	$errorStatus,
		string	$clientFilename = null,
		string	$clientMediaType = null
	)

Paramètres

string | resource	$streamOrFile
int	$size
int	$errorStatus
string | null	$clientFilename
string | null	$clientMediaType

Exceptions

Exception

Références UploadedFile\$clientFilename, UploadedFile\$clientMediaType, et UploadedFile\$size.

Documentation des fonctions membres

getClientFilename()

getClientFilename

(

)

{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.

Renvoie

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

}

Renvoie

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

Implémente UploadedFileInterface.

Références UploadedFile\$clientFilename.

getClientMediaType()

getClientMediaType

(

)

{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.

Renvoie

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

}

Implémente UploadedFileInterface.

Références UploadedFile\$clientMediaType.

getError()

getError

(

)

{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.

Voir également

http://php.net/manual/en/features.file-upload.errors.php

Renvoie

int One of PHP's UPLOAD_ERR_XXX constants.

}

Voir également

http://php.net/manual/en/features.file-upload.errors.php

Renvoie

int One of PHP's UPLOAD_ERR_XXX constants.

Implémente UploadedFileInterface.

Références UploadedFile\$error.

getSize()

getSize

(

)

{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.

Renvoie

int|null The file size in bytes or null if unknown.

}

Renvoie

int|null The file size in bytes or null if unknown.

Implémente UploadedFileInterface.

Références UploadedFile\$size.

getStream()

getStream

(

)

{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.

Renvoie

StreamInterface Stream representation of the uploaded file.

Exceptions

}

Exceptions

Exception

Implémente UploadedFileInterface.

Références UploadedFile\$stream, et UploadedFileErrorException\dueToStreamUploadError().

Référencé par UploadedFile\writeFile().

moveTo()

moveTo

(

$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.

Voir également

http://php.net/is_uploaded_file

http://php.net/move_uploaded_file

Paramètres

string

$targetPath

Path to which to move the uploaded file.

Exceptions

}

Voir également

http://php.net/is_uploaded_file

http://php.net/move_uploaded_file

Paramètres

string

$targetPath

Path to which to move the uploaded file.

Exceptions

Exception

Implémente UploadedFileInterface.

Références UploadedFileErrorException\dueToStreamUploadError(), UploadedFileErrorException\dueToUnwritableTarget(), UploadedFileErrorException\forUnmovableFile(), et UploadedFile\writeFile().

writeFile()

writeFile ( string  $path )

private

Write internal stream to given path

Paramètres

string

$path

Références $path, UploadedFile\$stream, UploadedFileErrorException\dueToUnwritablePath(), et UploadedFile\getStream().

Référencé par UploadedFile\moveTo().

Documentation des champs

$clientFilename

$clientFilename

private

Référencé par UploadedFile\__construct(), et UploadedFile\getClientFilename().

$clientMediaType

$clientMediaType

private

Référencé par UploadedFile\__construct(), et UploadedFile\getClientMediaType().

$error

$error

private

Référencé par UploadedFile\getError().

$file

$file

private

$moved

$moved = false

private

$size

$size

private

Référencé par UploadedFile\__construct(), et UploadedFile\getSize().

$stream

$stream

private

Référencé par UploadedFile\getStream(), et UploadedFile\writeFile().

ERROR_MESSAGES

const ERROR_MESSAGES

Valeur initiale :

= [
        UPLOAD_ERR_OK         => 'There is no error, the file uploaded with success'

UPLOAD_ERR_INI_SIZE

const UPLOAD_ERR_INI_SIZE

Valeur initiale :

=> 'The uploaded file exceeds the upload_max_filesize directive in php.ini',
        UPLOAD_ERR_FORM_SIZE  => 'The uploaded file exceeds the MAX_FILE_SIZE directive that was '
            . 'specified in the HTML form',
        UPLOAD_ERR_PARTIAL    => 'The uploaded file was only partially uploaded',
        UPLOAD_ERR_NO_FILE    => 'No file was uploaded',
        UPLOAD_ERR_NO_TMP_DIR => 'Missing a temporary folder',
        UPLOAD_ERR_CANT_WRITE => 'Failed to write file to disk',
        UPLOAD_ERR_EXTENSION  => 'A PHP extension stopped the file upload.',
    ]

---

La documentation de cette classe a été générée à partir du fichier suivant :

• laminas/laminas-diactoros/src/UploadedFile.php