Implements uploading from a HTTP resource. More...

Inheritance diagram for UploadFromUrl:

Collaboration diagram for UploadFromUrl:

Public Member Functions
	checkWarnings ()
	Wrapper around the parent function in order to defer checking warnings until the file really has been fetched. More...

	fetchFile ( $httpOptions=array())
	Download the file (if not async) More...

	getSourceType ()

	initialize ( $name, $url, $async=false)
	Entry point for API upload. More...

	initializeFromRequest (&$request)
	Entry point for SpecialUpload. More...

	performUpload ( $comment, $pageText, $watch, $user)
	Wrapper around the parent function in order to defer uploading to the job queue for asynchronous uploads. More...

	saveTempFileChunk ( $req, $buffer)
	Callback: save a chunk of the result of a HTTP request to the temporary file. More...

	verifyTitlePermissions ( $user)
	Wrapper around the parent function in order to defer checking protection until we are sure that the file can actually be uploaded. More...

	verifyUpload ()
	Wrapper around the parent function in order to defer verifying the upload until the file really has been fetched. More...

Public Member Functions inherited from UploadBase
	__construct ()

	checkSvgScriptCallback ( $element, $attribs, $data=null)

	cleanupTempFile ()
	If we've modified the upload file we need to manually remove it on exit to clean up. More...

	convertVerifyErrorToStatus ( $error)

	fetchFile ()
	Fetch the file. More...

	getFileSize ()
	Return the file size. More...

	getImageInfo ( $result)
	Gets image info about the file just uploaded. More...

	getLocalFile ()
	Return the local file and initializes if necessary. More...

	getRealPath ( $srcPath)

	getTempFileSha1Base36 ()
	Get the base 36 SHA1 of the file. More...

	getTempPath ()

	getTitle ()
	Returns the title of the file to be uploaded. More...

	getVerificationErrorCode ( $error)

	initializePathInfo ( $name, $tempPath, $fileSize, $removeTempFile=false)
	Initialize the path information. More...

	isEmptyFile ()
	Return true if the file is empty. More...

	stashFile (User $user=null)
	If the user does not supply all necessary information in the first upload form submission (either by accident or by design) then we may want to stash the file temporarily, get more information, and publish the file later. More...

	stashFileGetKey ()
	Stash a file in a temporary directory, returning a key which can be used to find the file again. More...

	stashSession ()
	alias for stashFileGetKey, for backwards compatibility More...

	validateName ()
	Verify that the name is valid and, if necessary, that we can overwrite. More...

	verifyPermissions ( $user)
	Alias for verifyTitlePermissions. More...

	zipEntryCallback ( $entry)
	Callback for ZipDirectoryReader to detect Java class files. More...

Static Public Member Functions
static	isAllowed ( $user)
	Checks if the user is allowed to use the upload-by-URL feature. More...

static	isAllowedHost ( $url)
	Checks whether the URL is for an allowed host The domains in the whitelist can include wildcard characters (*) in place of any of the domain levels, e.g. More...

static	isAllowedUrl ( $url)
	Checks whether the URL is not allowed. More...

static	isEnabled ()
	Checks if the upload from URL feature is enabled. More...

static	isValidRequest ( $request)

Static Public Member Functions inherited from UploadBase
static	checkFileExtension ( $ext, $list)
	Perform case-insensitive match against a list of file extensions. More...

static	checkFileExtensionList ( $ext, $list)
	Perform case-insensitive match against a list of file extensions. More...

static	checkSvgPICallback ( $target, $data)
	Callback to filter SVG Processing Instructions. More...

static	checkXMLEncodingMissmatch ( $file)
	Check a whitelist of xml encodings that are known not to be interpreted differently by the server's xml parser (expat) and some common browsers. More...

static	createFromRequest (&$request, $type=null)
	Create a form of UploadBase depending on wpSourceType and initializes it. More...

static	detectScript ( $file, $mime, $extension)
	Heuristic for detecting files that could contain JavaScript instructions or things that may look like HTML to a browser and are thus potentially harmful. More...

static	detectVirus ( $file)
	Generic wrapper function for a virus scanner program. More...

static	getExistsWarning ( $file)
	Helper function that does various existence checks for a file. More...

static	getFilenamePrefixBlacklist ()
	Get a list of blacklisted filename prefixes from [[MediaWiki:Filename-prefix-blacklist]]. More...

static	getMaxUploadSize ( $forType=null)

static	getSessionStatus ( $statusKey)
	Get the current status of a chunked upload (used for polling). More...

static	isThumbName ( $filename)
	Helper function that checks whether the filename looks like a thumbnail. More...

static	setSessionStatus ( $statusKey, $value)
	Set the current status of a chunked upload (used for polling). More...

static	splitExtensions ( $filename)
	Split a file into a base name and all dot-delimited 'extensions' on the end. More...

static	userCanReUpload (User $user, $img)
	Check if a user is the last uploader. More...

static	verifyExtension ( $mime, $extension)
	Checks if the mime type of the uploaded file matches the file extension. More...

Public Attributes
	$mTmpHandle

	$mUrl

Public Attributes inherited from UploadBase
	$mDestName

	$mFileProps

	$mFileSize

	$mFinalExtension

	$mRemoveTempFile

	$mSourceType

	$mSVGNSError

	$mTitleError = 0

const	EMPTY_FILE = 3

const	FILE_TOO_LARGE = 12

const	FILENAME_TOO_LONG = 14

const	FILETYPE_BADTYPE = 9

const	FILETYPE_MISSING = 8

const	HOOK_ABORTED = 11

const	ILLEGAL_FILENAME = 5

const	MIN_LENGTH_PARTNAME = 4

const	OK = 0

const	OVERWRITE_EXISTING_FILE = 7

const	SESSION_STATUS_KEY = 'wsUploadStatusData'

const	SUCCESS = 0

const	UPLOAD_VERIFICATION_ERROR = 11

const	VERIFICATION_ERROR = 10

const	WINDOWS_NONASCII_FILENAME = 13

Protected Member Functions
	insertJob ( $comment, $pageText, $watch, $user)

	makeTemporaryFile ()
	Create a new temporary file in the URL subdirectory of wfTempDir(). More...

	reallyFetchFile ( $httpOptions=array())
	Download the file, save it to the temporary file and update the file size and set $mRemoveTempFile to true. More...

Protected Member Functions inherited from UploadBase
	detectScriptInSvg ( $filename)

	verifyFile ()
	Verifies that it's ok to include the uploaded file. More...

	verifyMimeType ( $mime)
	Verify the mime type. More...

	verifyPartialFile ()
	A verification routine suitable for partial files. More...

Protected Attributes
	$mAsync

	$mIgnoreWarnings = true

	$mTempPath

Protected Attributes inherited from UploadBase
	$mBlackListedExtensions

	$mDesiredDestName

	$mFilteredName

	$mJavaDetected

	$mLocalFile

	$mTempPath

	$mTitle = false

Static Protected Attributes
static	$allowedUrls = array()

Static Protected Attributes inherited from UploadBase
static	$safeXmlEncodings = array( 'UTF-8', 'ISO-8859-1', 'ISO-8859-2', 'UTF-16', 'UTF-32' )

Additional Inherited Members
Static Public Attributes inherited from UploadBase
static	$uploadHandlers = array( 'Stash', 'File', 'Url' )

Detailed Description

Implements uploading from a HTTP resource.

Author: Bryan Tong Minh; Michael Dale

Definition at line 31 of file UploadFromUrl.php.

Member Function Documentation

◆ checkWarnings()

UploadFromUrl::checkWarnings ( )

Wrapper around the parent function in order to defer checking warnings until the file really has been fetched.

Returns: Array

Reimplemented from UploadBase.

Definition at line 308 of file UploadFromUrl.php.

References array().

◆ fetchFile()

UploadFromUrl::fetchFile ( $httpOptions = array() )

Download the file (if not async)

Parameters

Array $httpOptions Array of options for MWHttpRequest. Ignored if async. This could be used to override the timeout on the http request.

Returns: Status

Definition at line 191 of file UploadFromUrl.php.

References Http\isValidURI(), Status\newFatal(), Status\newGood(), and reallyFetchFile().

◆ getSourceType()

UploadFromUrl::getSourceType ( )

Returns: string

Reimplemented from UploadBase.

Definition at line 180 of file UploadFromUrl.php.

◆ initialize()

UploadFromUrl::initialize	(	$name,
		$url,
		$async = `false`
	)

Entry point for API upload.

Parameters

$name	string
$url	string
$async	mixed Whether the download should be performed asynchronous. False for synchronous, async or async-leavemessage for asynchronous download.

Exceptions

MWException

Definition at line 134 of file UploadFromUrl.php.

References $name, global, UploadBase\initializePathInfo(), and makeTemporaryFile().

Referenced by initializeFromRequest(), and ApiUpload\selectUploadModule().

◆ initializeFromRequest()

UploadFromUrl::initializeFromRequest ( & $request )

Entry point for SpecialUpload.

Parameters

$request WebRequest object

Reimplemented from UploadBase.

Definition at line 152 of file UploadFromUrl.php.

References initialize().

◆ insertJob()

UploadFromUrl::insertJob	(	$comment,
		$pageText,
		$watch,
		$user
	)

protected

Parameters

$comment
$pageText
$watch
$user	User

Returns: String

Definition at line 355 of file UploadFromUrl.php.

References $comment, $job, $mIgnoreWarnings, $user, array(), UploadBase\getTitle(), JobQueueGroup\singleton(), and UploadBase\stashSession().

Referenced by performUpload().

◆ isAllowed()

static UploadFromUrl::isAllowed ( $user )

static

Checks if the user is allowed to use the upload-by-URL feature.

If the user is not allowed, return the name of the user right as a string. If the user is allowed, have the parent do further permissions checking.

Parameters

$user User

Returns: bool|string

Reimplemented from UploadBase.

Definition at line 48 of file UploadFromUrl.php.

References $user.

Referenced by UploadForm\getSourceSection().

◆ isAllowedHost()

static UploadFromUrl::isAllowedHost ( $url )

static

Checks whether the URL is for an allowed host The domains in the whitelist can include wildcard characters (*) in place of any of the domain levels, e.g.

'*.flickr.com' or 'upload.*.gov.uk'.

Parameters

$url string

Returns: bool

Definition at line 72 of file UploadFromUrl.php.

References as, global, and wfParseUrl().

Referenced by ApiUpload\selectUploadModule().

◆ isAllowedUrl()

static UploadFromUrl::isAllowedUrl ( $url )

static

Checks whether the URL is not allowed.

Parameters

$url string

Returns: bool

Definition at line 115 of file UploadFromUrl.php.

References array(), and wfRunHooks().

Referenced by ApiUpload\selectUploadModule().

◆ isEnabled()

static UploadFromUrl::isEnabled ( )

static

Checks if the upload from URL feature is enabled.

Returns: bool

Reimplemented from UploadBase.

Definition at line 59 of file UploadFromUrl.php.

References global.

Referenced by UploadForm\getSourceSection(), and ApiUpload\selectUploadModule().

◆ isValidRequest()

static UploadFromUrl::isValidRequest ( $request )

static

Parameters

$request WebRequest object

Returns: bool

Reimplemented from UploadBase.

Definition at line 168 of file UploadFromUrl.php.

References $wgUser, global, and Http\isValidURI().

◆ makeTemporaryFile()

UploadFromUrl::makeTemporaryFile ( )

protected

Create a new temporary file in the URL subdirectory of wfTempDir().

Returns: string Path to the file

Definition at line 213 of file UploadFromUrl.php.

References TempFSFile\factory().

Referenced by initialize().

◆ performUpload()

UploadFromUrl::performUpload	(	$comment,
		$pageText,
		$watch,
		$user
	)

Wrapper around the parent function in order to defer uploading to the job queue for asynchronous uploads.

Parameters

$comment	string
$pageText	string
$watch	bool
$user	User

Returns: Status

Reimplemented from UploadBase.

Definition at line 338 of file UploadFromUrl.php.

References $comment, $user, insertJob(), and Status\newFatal().

◆ reallyFetchFile()

UploadFromUrl::reallyFetchFile ( $httpOptions = array() )

protected

Download the file, save it to the temporary file and update the file size and set $mRemoveTempFile to true.

Parameters

Array $httpOptions Array of options for MWHttpRequest

Returns: Status

Definition at line 247 of file UploadFromUrl.php.

References $options, array(), MWHttpRequest\factory(), global, and Status\newFatal().

Referenced by fetchFile().

◆ saveTempFileChunk()

UploadFromUrl::saveTempFileChunk	(	$req,
		$buffer
	)

Callback: save a chunk of the result of a HTTP request to the temporary file.

Parameters

$req	mixed
$buffer	string

Returns: int number of bytes handled

Definition at line 226 of file UploadFromUrl.php.

◆ verifyTitlePermissions()

UploadFromUrl::verifyTitlePermissions ( $user )

Wrapper around the parent function in order to defer checking protection until we are sure that the file can actually be uploaded.

Parameters

$user User

Returns: bool|mixed

Reimplemented from UploadBase.

Definition at line 322 of file UploadFromUrl.php.

References $user.

◆ verifyUpload()

UploadFromUrl::verifyUpload ( )

Wrapper around the parent function in order to defer verifying the upload until the file really has been fetched.

Returns: array|mixed

Reimplemented from UploadBase.

Definition at line 296 of file UploadFromUrl.php.

References array(), and UploadBase\OK.

Member Data Documentation

◆ $allowedUrls

UploadFromUrl::$allowedUrls = array()

staticprotected

Definition at line 37 of file UploadFromUrl.php.

◆ $mAsync

UploadFromUrl::$mAsync

protected

Definition at line 32 of file UploadFromUrl.php.

◆ $mIgnoreWarnings

UploadFromUrl::$mIgnoreWarnings = true

protected

Definition at line 33 of file UploadFromUrl.php.

Referenced by insertJob().

◆ $mTempPath

UploadFromUrl::$mTempPath

protected

Definition at line 35 of file UploadFromUrl.php.

◆ $mTmpHandle

UploadFromUrl::$mTmpHandle

Definition at line 35 of file UploadFromUrl.php.

◆ $mUrl

UploadFromUrl::$mUrl

Definition at line 32 of file UploadFromUrl.php.

The documentation for this class was generated from the following file:

includes/upload/UploadFromUrl.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Static Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ checkWarnings()

◆ fetchFile()

◆ getSourceType()

◆ initialize()

◆ initializeFromRequest()

◆ insertJob()

◆ isAllowed()

◆ isAllowedHost()

◆ isAllowedUrl()

◆ isEnabled()

◆ isValidRequest()

◆ makeTemporaryFile()

◆ performUpload()

◆ reallyFetchFile()

◆ saveTempFileChunk()

◆ verifyTitlePermissions()

◆ verifyUpload()

Member Data Documentation

◆ $allowedUrls

◆ $mAsync

◆ $mIgnoreWarnings

◆ $mTempPath

◆ $mTmpHandle

◆ $mUrl