public function UploadedFileInterface::moveTo in Zircon Profile 8.0

Same name and namespace in other branches

1. 8 vendor/psr/http-message/src/UploadedFileInterface.php \Psr\Http\Message\UploadedFileInterface::moveTo()

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

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

See also

http://php.net/is_uploaded_file

http://php.net/move_uploaded_file

2 methods override UploadedFileInterface::moveTo()

UploadedFile::moveTo in vendor/zendframework/zend-diactoros/src/UploadedFile.php

UploadedFile::moveTo in vendor/symfony/psr-http-message-bridge/Tests/Fixtures/UploadedFile.php

Move the uploaded file to a new location.

File

vendor/psr/http-message/src/UploadedFileInterface.php, line 65

Class

UploadedFileInterface

Value object representing a file uploaded through an HTTP request.

Namespace

Psr\Http\Message

Code

public function moveTo($targetPath);