MediaWiki 1.30.2

[autoinstallsdev/mediawiki.git] / includes / upload / UploadFromFile.php

diff --git a/includes/upload/UploadFromFile.php b/includes/upload/UploadFromFile.php
index e67ec191b0cfde84a2b1a2a8fed8074157b09126..675bb8d4534097a426eadf5db93d293434e231fd 100644 (file)
--- a/includes/upload/UploadFromFile.php
+++ b/includes/upload/UploadFromFile.php
@@ -1,65 +1,97 @@
 <?php
 /**
- * Implements regular file uploads
+ * Backend for regular file upload.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
  *
  * @file
- * @ingroup upload
- * @author Bryan Tong Minh
+ * @ingroup Upload
  */
 
+/**
+ * Implements regular file uploads
+ *
+ * @ingroup Upload
+ * @author Bryan Tong Minh
+ */
 class UploadFromFile extends UploadBase {
+       /**
+        * @var WebRequestUpload
+        */
        protected $mUpload = null;
 
+       /**
+        * @param WebRequest &$request
+        */
        function initializeFromRequest( &$request ) {
-               $upload = $request->getUpload( 'wpUploadFile' );                
+               $upload = $request->getUpload( 'wpUploadFile' );
                $desiredDestName = $request->getText( 'wpDestFile' );
-               if( !$desiredDestName )
+               if ( !$desiredDestName ) {
                        $desiredDestName = $upload->getName();
-                       
-               return $this->initialize( $desiredDestName, $upload );
+               }
+
+               $this->initialize( $desiredDestName, $upload );
        }
-       
+
        /**
         * Initialize from a filename and a WebRequestUpload
+        * @param string $name
+        * @param WebRequestUpload $webRequestUpload
         */
        function initialize( $name, $webRequestUpload ) {
                $this->mUpload = $webRequestUpload;
-               return $this->initializePathInfo( $name, 
+               $this->initializePathInfo( $name,
                        $this->mUpload->getTempName(), $this->mUpload->getSize() );
        }
+
+       /**
+        * @param WebRequest $request
+        * @return bool
+        */
        static function isValidRequest( $request ) {
                # Allow all requests, even if no file is present, so that an error
                # because a post_max_size or upload_max_filesize overflow
                return true;
        }
-       
+
+       /**
+        * @return string
+        */
+       public function getSourceType() {
+               return 'file';
+       }
+
+       /**
+        * @return array
+        */
        public function verifyUpload() {
-               # Check for a post_max_size or upload_max_size overflow, so that a 
+               # Check for a post_max_size or upload_max_size overflow, so that a
                # proper error can be shown to the user
                if ( is_null( $this->mTempPath ) || $this->isEmptyFile() ) {
                        if ( $this->mUpload->isIniSizeOverflow() ) {
-                               global $wgMaxUploadSize;
-                               return array( 
+                               return [
                                        'status' => UploadBase::FILE_TOO_LARGE,
-                                       'max' => min( 
-                                               $wgMaxUploadSize, 
-                                               wfShorthandToInteger( ini_get( 'upload_max_filesize' ) ), 
-                                               wfShorthandToInteger( ini_get( 'post_max_size' ) )
+                                       'max' => min(
+                                               self::getMaxUploadSize( $this->getSourceType() ),
+                                               self::getMaxPhpUploadSize()
                                        ),
-                               );
+                               ];
                        }
                }
-               
-               return parent::verifyUpload();
-       }
 
-       /** 
-        * Get the path to the file underlying the upload
-        * @return String path to file
-        */
-       public function getFileTempname() {
-               return $this->mUpload->getTempname();
+               return parent::verifyUpload();
        }
-
-       
 }