clientFilename = $name; $this->error = $error; $this->clientMediaType = $type; $this->size = $size; if (file_exists($tmpName)) { $this->tmpName = $tmpName; $this->stream = new Stream(fopen($tmpName, "r")); } else { $this->stream = new NullStream(); } } /** * Retrieve a stream representing the uploaded file. * * This method returns 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 will raise * an exception. * * @return StreamInterface Stream representation of the uploaded file. * @throws \RuntimeException in cases when no stream is available or can be * created. */ public function getStream() { if ($this->moved) { throw new \RuntimeException("File has already been moved"); } return $this->stream; } /** * 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. * * The original file or stream will be removed on completion. * * If this method is called more than once, any subsequent calls will raise * an exception. * * @see http://php.net/is_uploaded_file * @see http://php.net/move_uploaded_file * @param string $path Path to which to move the uploaded file. * @throws \InvalidArgumentException if the $path specified is invalid. * @throws \RuntimeException on any error during the move operation, or on * the second or subsequent call to the method. */ public function moveTo($path) { if ($this->tmpName === null || !file_exists($this->tmpName)) { throw new \RuntimeException("File " . $this->tmpName . " does not exist."); } $sapi = php_sapi_name(); $whitelist = ["apache", "apache2filter", "apache2handler", "cgi", "fpm-fcgi", "cgi-fcgi"]; if (in_array($sapi, $whitelist)) { // @codeCoverageIgnoreStart move_uploaded_file($this->tmpName, $path); } else { // @codeCoverageIgnoreEnd rename($this->tmpName, $path); } $this->moved = true; } /** * Retrieve the file size. * * @return int|null The file size in bytes or null if unknown. */ public function getSize() { return $this->size; } /** * Retrieve the error associated with the uploaded file. * * The return value will be one of PHP's UPLOAD_ERR_XXX constants. * * If the file was uploaded successfully, this method will return * UPLOAD_ERR_OK. * * @see http://php.net/manual/en/features.file-upload.errors.php * @return int One of PHP's UPLOAD_ERR_XXX constants. */ public function getError() { return $this->error; } /** * 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. * * @return string|null The filename sent by the client or null if none * was provided. */ public function getClientFilename() { return $this->clientFilename; } /** * 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. * * @return string|null The media type sent by the client or null if none * was provided. */ public function getClientMediaType() { return $this->clientMediaType; } }