request = $request; $this->doesExist = isset( $_FILES[$key] ); if ( $this->doesExist ) { $this->fileInfo = $_FILES[$key]; } } /** * Return whether a file with this name was uploaded. * * @return bool */ public function exists() { return $this->doesExist; } /** * Return the original filename of the uploaded file * * @return string|null Filename or null if non-existent */ public function getName() { if ( !$this->exists() ) { return null; } $name = $this->fileInfo['name']; # Safari sends filenames in HTML-encoded Unicode form D... # Horrid and evil! Let's try to make some kind of sense of it. $name = Sanitizer::decodeCharReferences( $name ); $name = MediaWikiServices::getInstance()->getContentLanguage()->normalize( $name ); wfDebug( __METHOD__ . ": {$this->fileInfo['name']} normalized to '$name'" ); return $name; } /** * Return the file size of the uploaded file * * @return int File size or zero if non-existent */ public function getSize() { if ( !$this->exists() ) { return 0; } return $this->fileInfo['size']; } /** * Return the path to the temporary file * * @return string|null Path or null if non-existent */ public function getTempName() { if ( !$this->exists() ) { return null; } return $this->fileInfo['tmp_name']; } /** * Return the client specified content type * * @since 1.35 * @return string|null Type or null if non-existent */ public function getType() { if ( !$this->exists() ) { return null; } return $this->fileInfo['type']; } /** * Return the upload error. See link for explanation * https://www.php.net/manual/en/features.file-upload.errors.php * * @return int One of the UPLOAD_ constants, 0 if non-existent */ public function getError() { if ( !$this->exists() ) { return 0; # UPLOAD_ERR_OK } return $this->fileInfo['error']; } /** * Returns whether this upload failed because of overflow of a maximum set * in php.ini * * @return bool */ public function isIniSizeOverflow() { if ( $this->getError() == UPLOAD_ERR_INI_SIZE ) { # PHP indicated that upload_max_filesize is exceeded return true; } $contentLength = $this->request->getHeader( 'Content-Length' ); $maxPostSize = wfShorthandToInteger( ini_get( 'post_max_size' ), 0 ); if ( $maxPostSize && $contentLength > $maxPostSize ) { # post_max_size is exceeded return true; } return false; } }