3 * Object to access the $_FILES array
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
23 use MediaWiki\MediaWikiServices
;
26 * Object to access the $_FILES array
30 class WebRequestUpload
{
36 * Constructor. Should only be called by WebRequest
38 * @param WebRequest $request The associated request
39 * @param string $key Key in $_FILES array (name of form field)
41 public function __construct( $request, $key ) {
42 $this->request
= $request;
43 $this->doesExist
= isset( $_FILES[$key] );
44 if ( $this->doesExist
) {
45 $this->fileInfo
= $_FILES[$key];
50 * Return whether a file with this name was uploaded.
54 public function exists() {
55 return $this->doesExist
;
59 * Return the original filename of the uploaded file
61 * @return string|null Filename or null if non-existent
63 public function getName() {
64 if ( !$this->exists() ) {
68 $name = $this->fileInfo
['name'];
70 # Safari sends filenames in HTML-encoded Unicode form D...
71 # Horrid and evil! Let's try to make some kind of sense of it.
72 $name = Sanitizer
::decodeCharReferences( $name );
73 $name = MediaWikiServices
::getInstance()->getContentLanguage()->normalize( $name );
74 wfDebug( __METHOD__
. ": {$this->fileInfo['name']} normalized to '$name'" );
79 * Return the file size of the uploaded file
81 * @return int File size or zero if non-existent
83 public function getSize() {
84 if ( !$this->exists() ) {
88 return $this->fileInfo
['size'];
92 * Return the path to the temporary file
94 * @return string|null Path or null if non-existent
96 public function getTempName() {
97 if ( !$this->exists() ) {
101 return $this->fileInfo
['tmp_name'];
105 * Return the client specified content type
108 * @return string|null Type or null if non-existent
110 public function getType() {
111 if ( !$this->exists() ) {
115 return $this->fileInfo
['type'];
119 * Return the upload error. See link for explanation
120 * https://www.php.net/manual/en/features.file-upload.errors.php
122 * @return int One of the UPLOAD_ constants, 0 if non-existent
124 public function getError() {
125 if ( !$this->exists() ) {
126 return 0; # UPLOAD_ERR_OK
129 return $this->fileInfo
['error'];
133 * Returns whether this upload failed because of overflow of a maximum set
138 public function isIniSizeOverflow() {
139 if ( $this->getError() == UPLOAD_ERR_INI_SIZE
) {
140 # PHP indicated that upload_max_filesize is exceeded
144 $contentLength = $this->request
->getHeader( 'Content-Length' );
145 $maxPostSize = wfShorthandToInteger( ini_get( 'post_max_size' ), 0 );
147 if ( $maxPostSize && $contentLength > $maxPostSize ) {
148 # post_max_size is exceeded