The WebRequest class encapsulates getting at data passed in the URL or via a POSTed form stripping illegal input characters and normalizing Unicode sequences. More...

Inheritance diagram for WebRequest:

[legend]

Collaboration diagram for WebRequest:

[legend]

Public Member Functions
	__construct ()

	appendQueryArray ( $array)
	Appends or replaces value of query variables.

	appendQueryValue ( $key, $value)

	checkUrlExtension ( $extWhitelist=[])
	Check if Internet Explorer will detect an incorrect cache extension in PATH_INFO or QUERY_STRING.

	getAcceptLang ()
	Parse the Accept-Language header sent by the client into an array.

	getAllHeaders ()
	Get an array containing all request headers.

	getArray ( $name, $default=null)
	Fetch an array from the input or return $default if it's not set.

	getBool ( $name, $default=false)
	Fetch a boolean value from the input or return $default if not set.

	getCheck ( $name)
	Return true if the named value is set in the input, whatever that value is (even "0").

	getCookie ( $key, $prefix=null, $default=null)
	Get a cookie from the $_COOKIE jar.

	getElapsedTime ()
	Get the number of seconds to have elapsed since request start, in fractional seconds, with microsecond resolution.

	getFileName ( $key)
	Return the original filename of the uploaded file, as reported by the submitting user agent.

	getFileTempname ( $key)
	Return the path to the temporary file where PHP has stored the upload.

	getFloat ( $name, $default=0.0)
	Fetch a floating point value from the input or return $default if not set.

	getFullRequestURL ()
	Return the request URI with the canonical service and hostname, path, and query string.

	getFuzzyBool ( $name, $default=false)
	Fetch a boolean value from the input or return $default if not set.

	getHeader ( $name, $flags=0)
	Get a request header, or false if it isn't set.

	getInt ( $name, $default=0)
	Fetch an integer value from the input or return $default if not set.

	getIntArray ( $name, $default=null)
	Fetch an array of integers, or return $default if it's not set.

	getIntOrNull ( $name)
	Fetch an integer value from the input or return null if empty.

	getIP ()
	Work out the IP address based on various globals For trusted proxies, use the XFF client IP (first of the chain)

	getLimitOffset ( $deflimit=50, $optionname='rclimit')
	Check for limit and offset parameters on the input, and return sensible defaults if not given.

	getMethod ()
	Get the HTTP method used for this request.

	getPostValues ()
	Get the values passed via POST.

	getProtocol ()
	Get the current URL protocol (http or https)

	getQueryValues ()
	Get the values passed in the query string.

	getRawInput ()
	Return the raw request body, with no processing.

	getRawPostString ()
	Return the contents of the POST with no decoding.

	getRawQueryString ()
	Return the contents of the Query with no decoding.

	getRawVal ( $name, $default=null)
	Fetch a scalar from the input without normalization, or return $default if it's not set.

	getRequestURL ()
	Return the path and query string portion of the request URI.

	getSession ()
	Return the session for this request.

	getSessionData ( $key)
	Get data from the session.

	getSessionId ()
	Get the session id for this request, if any.

	getText ( $name, $default='')
	Fetch a text string from the given array or return $default if it's not set.

	getUpload ( $key)
	Return a WebRequestUpload object corresponding to the key.

	getUploadError ( $key)
	Return the upload error or 0.

	getVal ( $name, $default=null)
	Fetch a scalar from the input or return $default if it's not set.

	getValueNames ( $exclude=[])
	Returns the names of all input values excluding those in $exclude.

	getValues ()
	Extracts the given named values into an array.

	hasSafeMethod ()
	Check if this request uses a "safe" HTTP method.

	interpolateTitle ()
	Check for title, action, and/or variant data in the URL and interpolate it into the GET variables.

	isSafeRequest ()
	Whether this request should be identified as being "safe".

	markAsSafeRequest ()
	Mark this request as identified as being nullipotent even if it is a POST request.

	normalizeUnicode ( $data)
	Recursively normalizes UTF-8 strings in the given array.

	response ()
	Return a handle to WebResponse style object, for setting cookies, headers and other stuff, for Request being worked on.

	setIP ( $ip)

	setSessionData ( $key, $data)
	Set session data.

	setSessionId (SessionId $sessionId)
	Set the session for this request.

	setVal ( $key, $value)
	Set an arbitrary value into our get/post data.

	unsetVal ( $key)
	Unset an arbitrary value from our get/post data.

	wasPosted ()
	Returns true if the present request was reached by a POST operation, false otherwise (GET, HEAD, or command-line).

Static Public Member Functions
static	detectProtocol ()
	Detect the protocol from $_SERVER.

static	detectServer ()
	Work out an appropriate URL prefix containing scheme and host, based on information detected from $_SERVER.

static	extractTitle ( $path, $bases, $key=false)
	URL rewriting function; tries to extract page title and, optionally, one other fixed parameter value from a URL path.

static	getGlobalRequestURL ()
	Return the path and query string portion of the main request URI.

static	getPathInfo ( $want='all')
	Extract relevant query arguments from the http request uri's path to be merged with the normal php provided query arguments.

static	getRequestId ()
	Get the unique request ID.

static	overrideRequestId ( $id)
	Override the unique request ID.

Public Attributes
const	GETHEADER_LIST = 1
	Flag to make WebRequest::getHeader return an array of values.

Protected Member Functions
	doSecurityRedirect ( $url)
	Attempt to redirect to a URL with a QUERY_STRING that's not dangerous in IE 6.

	getRawIP ()
	Fetch the raw IP from the request.

	initHeaders ()
	Initialise the header list.

Protected Attributes
	$data

	$headers = []

bool	$markedAsSafe = false
	Whether this HTTP request is "safe" (even if it is an HTTP post)

string	$protocol
	Cached URL protocol.

float	$requestTime
	The timestamp of the start of the request, with microsecond precision.

SessionId null	$sessionId = null
	Session ID to use for this request.

Private Member Functions
	getGPCVal ( $arr, $name, $default)
	Fetch a value from the given array or return $default if it's not set.

Private Attributes
string	$ip
	Cached client IP address.

WebResponse	$response
	Lazy-init response object.

Static Private Attributes
static string	$reqId
	The unique request ID.

Detailed Description

The WebRequest class encapsulates getting at data passed in the URL or via a POSTed form stripping illegal input characters and normalizing Unicode sequences.

Definition at line 41 of file WebRequest.php.

Constructor & Destructor Documentation

◆ __construct()

WebRequest::__construct ( )

Definition at line 93 of file WebRequest.php.

Member Function Documentation

◆ appendQueryArray()

WebRequest::appendQueryArray ( $array )

Appends or replaces value of query variables.

Parameters

array $array Array of values to replace/add to query

Returns: string

Definition at line 877 of file WebRequest.php.

References getQueryValues(), and wfArrayToCgi().

Referenced by appendQueryValue().

◆ appendQueryValue()

WebRequest::appendQueryValue	(		$key,
			$value )

Parameters

string	$key
string	$value

Returns: string

Definition at line 867 of file WebRequest.php.

References $value, and appendQueryArray().

◆ checkUrlExtension()

WebRequest::checkUrlExtension ( $extWhitelist = [] )

Check if Internet Explorer will detect an incorrect cache extension in PATH_INFO or QUERY_STRING.

If the request can't be allowed, show an error message or redirect to a safer URL. Returns true if the URL is OK, and false if an error message has been shown and the request should be aborted.

Parameters

array $extWhitelist

Exceptions

HttpError

Returns: bool

Reimplemented in FauxRequest.

Definition at line 1074 of file WebRequest.php.

References IEUrlExtension\areServerVarsBad(), doSecurityRedirect(), IEUrlExtension\fixUrlForIE6(), getFullRequestURL(), and wasPosted().

◆ detectProtocol()

static WebRequest::detectProtocol ( )

static

Detect the protocol from $_SERVER.

This is for use prior to Setup.php, when no WebRequest object is available. At other times, use the non-static function getProtocol().

Returns: string

Definition at line 246 of file WebRequest.php.

◆ detectServer()

static WebRequest::detectServer ( )

static

Work out an appropriate URL prefix containing scheme and host, based on information detected from $_SERVER.

Returns: string

Definition at line 200 of file WebRequest.php.

References $wgAssumeProxiesUseDefaultProtocolPorts.

◆ doSecurityRedirect()

WebRequest::doSecurityRedirect ( $url )

protected

Attempt to redirect to a URL with a QUERY_STRING that's not dangerous in IE 6.

Returns true if it was successful, false otherwise.

Parameters

string $url

Returns: bool

Definition at line 1098 of file WebRequest.php.

References redirect.

Referenced by checkUrlExtension().

◆ extractTitle()

static WebRequest::extractTitle	(	$path,
		$bases,
		$key = false )

static

URL rewriting function; tries to extract page title and, optionally, one other fixed parameter value from a URL path.

Parameters

string	$path	The URL path given from the client
array	$bases	One or more URLs, optionally with $1 at the end
string \| bool	$key	If provided, the matching key in $bases will be passed on as the value of this URL parameter

Returns: array Array of URL variables to interpolate; empty if no match

Definition at line 336 of file WebRequest.php.

References $base, $matches, and array().

◆ getAcceptLang()

WebRequest::getAcceptLang ( )

Parse the Accept-Language header sent by the client into an array.

Returns: array Array( languageCode => q-value ) sorted by q-value in descending order then appearing time in the header in ascending order. May contain the "language" '*', which applies to languages other than those explicitly listed. This is aligned with rfc2616 section 14.4 Preference for earlier languages appears in rfc3282 as an extension to HTTP/1.1.

Reimplemented in DerivativeRequest.

Definition at line 1134 of file WebRequest.php.

◆ getAllHeaders()

WebRequest::getAllHeaders ( )

Get an array containing all request headers.

Returns: array Mapping header name to its value

Reimplemented in DerivativeRequest.

Definition at line 1012 of file WebRequest.php.

References initHeaders().

◆ getArray()

WebRequest::getArray	(		$name,
			$default = null )

Fetch an array from the input or return $default if it's not set.

If source was scalar, will return an array with a single element. If no source and no default, returns null.

Parameters

string	$name
array \| null	$default	Optional default (or null)

Returns: array|null

Definition at line 490 of file WebRequest.php.

References array(), and getGPCVal().

Referenced by FormOptions\fetchValuesFromRequest(), and getIntArray().

◆ getBool()

WebRequest::getBool	(		$name,
			$default = false )

Fetch a boolean value from the input or return $default if not set.

Guaranteed to return true or false, with normal PHP semantics for boolean interpretation of strings.

Parameters

string	$name
bool	$default

Returns: bool

Definition at line 568 of file WebRequest.php.

References getRawVal().

Referenced by FormOptions\fetchValuesFromRequest(), and getFuzzyBool().

◆ getCheck()

WebRequest::getCheck ( $name )

Return true if the named value is set in the input, whatever that value is (even "0").

Return false if the named value is not set. Example use is checking for the presence of check boxes in forms.

Parameters

string $name

Returns: bool

Definition at line 594 of file WebRequest.php.

References getRawVal().

◆ getCookie()

WebRequest::getCookie	(	$key,
		$prefix = null,
		$default = null )

Get a cookie from the $_COOKIE jar.

Parameters

string	$key	The name of the cookie
string \| null	$prefix	A prefix to use for the cookie name, if not $wgCookiePrefix
mixed \| null	$default	What to return if the value isn't found

Returns: mixed Cookie value or $default if the cookie not set

Reimplemented in DerivativeRequest, and FauxRequest.

Definition at line 783 of file WebRequest.php.

References $wgCookiePrefix, and getGPCVal().

◆ getElapsedTime()

WebRequest::getElapsedTime ( )

Get the number of seconds to have elapsed since request start, in fractional seconds, with microsecond resolution.

Returns: float

Since: 1.25

Reimplemented in DerivativeRequest.

Definition at line 263 of file WebRequest.php.

◆ getFileName()

WebRequest::getFileName ( $key )

Return the original filename of the uploaded file, as reported by the submitting user agent.

HTML-style character entities are interpreted and normalized to Unicode normalization form C, in part to deal with weird input from Safari with non-ASCII filenames.

Other than this the name is not verified for being a safe filename.

Parameters

string $key

Returns: string|null String or null if no such file.

Definition at line 952 of file WebRequest.php.

◆ getFileTempname()

WebRequest::getFileTempname ( $key )

Return the path to the temporary file where PHP has stored the upload.

Parameters

string $key

Returns: string|null String or null if no such file.

Definition at line 925 of file WebRequest.php.

◆ getFloat()

WebRequest::getFloat	(		$name,
			$default = 0.0 )

Fetch a floating point value from the input or return $default if not set.

Guaranteed to return a float; non-numeric input will typically return 0.

Since: 1.23

Parameters

string	$name
float	$default

Returns: float

Definition at line 555 of file WebRequest.php.

References getRawVal().

Referenced by FormOptions\fetchValuesFromRequest().

◆ getFullRequestURL()

WebRequest::getFullRequestURL ( )

Return the request URI with the canonical service and hostname, path, and query string.

This will be suitable for use as an absolute link in HTML or other output.

If $wgServer is protocol-relative, this will return a fully qualified URL with the protocol that was used for this request.

Returns: string

Definition at line 858 of file WebRequest.php.

References getRequestURL(), PROTO_CURRENT, and wfGetServerUrl().

Referenced by checkUrlExtension().

◆ getFuzzyBool()

WebRequest::getFuzzyBool	(		$name,
			$default = false )

Fetch a boolean value from the input or return $default if not set.

Unlike getBool, the string "false" will result in boolean false, which is useful when interpreting information sent from JavaScript.

Parameters

string	$name
bool	$default

Returns: bool

Definition at line 581 of file WebRequest.php.

References getBool(), and getRawVal().

◆ getGlobalRequestURL()

static WebRequest::getGlobalRequestURL ( )

static

Return the path and query string portion of the main request URI.

This will be suitable for use as a relative link in HTML output.

Exceptions

MWException

Returns: string

Definition at line 798 of file WebRequest.php.

References $base.

◆ getGPCVal()

WebRequest::getGPCVal	(	$arr,
		$name,
		$default )

private

Fetch a value from the given array or return $default if it's not set.

Parameters

array	$arr
string	$name
mixed	$default

Returns: mixed

Definition at line 383 of file WebRequest.php.

References $data, $name, and normalizeUnicode().

Referenced by getArray(), getCookie(), getVal(), and getValues().

◆ getHeader()

WebRequest::getHeader	(		$name,
			$flags = 0 )

Get a request header, or false if it isn't set.

Parameters

string	$name	Case-insensitive header name
int	$flags	Bitwise combination of: WebRequest::GETHEADER_LIST Treat the header as a comma-separated list of values, as described in RFC 2616 § 4.2. (since 1.26).

Returns: string|array|bool False if header is unset; otherwise the header value(s) as either a string (the default) or an array, if WebRequest::GETHEADER_LIST flag was set.

Reimplemented in DerivativeRequest.

Definition at line 1029 of file WebRequest.php.

References $name, $value, and initHeaders().

◆ getInt()

WebRequest::getInt	(		$name,
			$default = 0 )

Fetch an integer value from the input or return $default if not set.

Guaranteed to return an integer; non-numeric input will typically return 0.

Parameters

string	$name
int	$default

Returns: int

Definition at line 526 of file WebRequest.php.

References getRawVal().

Referenced by FormOptions\fetchValuesFromRequest(), and getLimitOffset().

◆ getIntArray()

WebRequest::getIntArray	(		$name,
			$default = null )

Fetch an array of integers, or return $default if it's not set.

If source was scalar, will return an array with a single element. If no source and no default, returns null. If an array is returned, contents are guaranteed to be integers.

Parameters

string	$name
array \| null	$default	Option default (or null)

Returns: array Array of ints

Definition at line 509 of file WebRequest.php.

References getArray().

◆ getIntOrNull()

WebRequest::getIntOrNull ( $name )

Fetch an integer value from the input or return null if empty.

Guaranteed to return an integer or null; non-numeric input will typically return null.

Parameters

string $name

Returns: int|null

Definition at line 538 of file WebRequest.php.

References getRawVal().

Referenced by FormOptions\fetchValuesFromRequest().

◆ getIP()

WebRequest::getIP ( )

Work out the IP address based on various globals For trusted proxies, use the XFF client IP (first of the chain)

Since: 1.19

Exceptions

MWException

Returns: string

Reimplemented in DerivativeRequest.

Definition at line 1211 of file WebRequest.php.

Referenced by MWRestrictions\check().

◆ getLimitOffset()

WebRequest::getLimitOffset	(		$deflimit = 50,
			$optionname = 'rclimit' )

Check for limit and offset parameters on the input, and return sensible defaults if not given.

The limit must be positive and is capped at 5000. Offset must be positive but is not capped.

Parameters

int	$deflimit	Limit to use if no input and the user hasn't set the option.
string	$optionname	To specify an option other than rclimit to pull from.

Returns: int[] First element is limit, second is offset

Definition at line 894 of file WebRequest.php.

References getInt().

◆ getMethod()

WebRequest::getMethod ( )

Get the HTTP method used for this request.

Returns: string

Reimplemented in FauxRequest.

Definition at line 715 of file WebRequest.php.

Referenced by wasPosted().

◆ getPathInfo()

static WebRequest::getPathInfo ( $want = 'all' )

static

Extract relevant query arguments from the http request uri's path to be merged with the normal php provided query arguments.

Tries to use the REQUEST_URI data if available and parses it according to the wiki's configuration looking for any known pattern.

If the REQUEST_URI is not provided we'll fall back on the PATH_INFO provided by the server if any and use that to set a 'title' parameter.

Parameters

string $want If this is not 'all', then the function will return an empty array if it determines that the URL is inside a rewrite path.

Returns: array Any query arguments found in path matches.

Definition at line 116 of file WebRequest.php.

References $matches, $wgActionPaths, $wgArticlePath, $wgScript, $wgUsePathInfo, $wgVariantArticlePath, and PathRouter\add().

◆ getPostValues()

WebRequest::getPostValues ( )

Get the values passed via POST.

No transformation is performed on the values.

Since: 1.32

Returns: array

Definition at line 667 of file WebRequest.php.

◆ getProtocol()

WebRequest::getProtocol ( )

Get the current URL protocol (http or https)

Returns: string

Reimplemented in DerivativeRequest, and FauxRequest.

Definition at line 300 of file WebRequest.php.

◆ getQueryValues()

WebRequest::getQueryValues ( )

Get the values passed in the query string.

No transformation is performed on the values.

Returns: array

Reimplemented in FauxRequest.

Definition at line 655 of file WebRequest.php.

Referenced by appendQueryArray().

◆ getRawInput()

WebRequest::getRawInput ( )

Return the raw request body, with no processing.

Cached since some methods disallow reading the stream more than once. As stated in the php docs, this does not work with enctype="multipart/form-data".

Returns: string

Reimplemented in FauxRequest.

Definition at line 702 of file WebRequest.php.

References $input.

Referenced by getRawPostString().

◆ getRawIP()

WebRequest::getRawIP ( )

protected

Fetch the raw IP from the request.

Since: 1.19

Exceptions

MWException

Returns: string

Reimplemented in FauxRequest.

Definition at line 1187 of file WebRequest.php.

◆ getRawPostString()

WebRequest::getRawPostString ( )

Return the contents of the POST with no decoding.

Use when you need to know exactly what was sent, e.g. for an OAuth signature over the elements.

Returns: string

Reimplemented in FauxRequest.

Definition at line 688 of file WebRequest.php.

References getRawInput(), and wasPosted().

◆ getRawQueryString()

WebRequest::getRawQueryString ( )

Return the contents of the Query with no decoding.

Use when you need to know exactly what was sent, e.g. for an OAuth signature over the elements.

Returns: string

Reimplemented in FauxRequest.

Definition at line 678 of file WebRequest.php.

◆ getRawVal()

WebRequest::getRawVal	(		$name,
			$default = null )

Fetch a scalar from the input without normalization, or return $default if it's not set.

Unlike self::getVal(), this does not perform any normalization on the input value.

Since: 1.28

Parameters

string	$name
string \| null	$default

Returns: string|null

Definition at line 416 of file WebRequest.php.

References $name.

Referenced by ResourceLoaderContext\__construct(), getBool(), getCheck(), getFloat(), getFuzzyBool(), getInt(), and getIntOrNull().

◆ getRequestId()

static WebRequest::getRequestId ( )

static

Get the unique request ID.

This is either the value of the UNIQUE_ID envvar (if present) or a randomly-generated 24-character string.

Returns: string

Since: 1.27

Definition at line 275 of file WebRequest.php.

References wfRandomString().

◆ getRequestURL()

WebRequest::getRequestURL ( )

Return the path and query string portion of the request URI.

This will be suitable for use as a relative link in HTML output.

Exceptions

MWException

Returns: string

Reimplemented in FauxRequest.

Definition at line 844 of file WebRequest.php.

Referenced by getFullRequestURL().

◆ getSession()

WebRequest::getSession ( )

Return the session for this request.

This might unpersist an existing session if it was invalid.

Since: 1.27

Note: For performance, keep the session locally if you will be making much use of it instead of calling this method repeatedly.

Returns: Session

Reimplemented in DerivativeRequest.

Definition at line 742 of file WebRequest.php.

Referenced by FauxRequest\getSessionArray(), getSessionData(), and setSessionData().

◆ getSessionData()

WebRequest::getSessionData ( $key )

Get data from the session.

Note: Prefer $this->getSession() instead if making multiple calls.

Parameters

string $key Name of key in the session

Returns: mixed

Reimplemented in DerivativeRequest.

Definition at line 1049 of file WebRequest.php.

References getSession().

◆ getSessionId()

WebRequest::getSessionId ( )

Get the session id for this request, if any.

Since: 1.27

Access:\n private For use by MediaWiki\Session classes only

Returns: SessionId|null

Definition at line 771 of file WebRequest.php.

◆ getText()

WebRequest::getText	(		$name,
			$default = '' )

Fetch a text string from the given array or return $default if it's not set.

Carriage returns are stripped from the text. This should generally be used for form "<textarea>" and "<input>" fields, and for user-supplied freeform text input.

Parameters

string	$name
string	$default	Optional

Returns: string

Reimplemented in FauxRequest.

Definition at line 610 of file WebRequest.php.

References getVal().

Referenced by FormOptions\fetchValuesFromRequest().

◆ getUpload()

WebRequest::getUpload ( $key )

Return a WebRequestUpload object corresponding to the key.

Parameters

string $key

Returns: WebRequestUpload

Definition at line 963 of file WebRequest.php.

◆ getUploadError()

WebRequest::getUploadError ( $key )

Return the upload error or 0.

Parameters

string $key

Returns: int

Definition at line 936 of file WebRequest.php.

◆ getVal()

WebRequest::getVal	(		$name,
			$default = null )

Fetch a scalar from the input or return $default if it's not set.

Returns a string. Arrays are discarded. Useful for non-freeform text inputs (e.g. predefined internal text keys selected by a drop-down menu). For freeform input, see getText().

Parameters

string	$name
string \| null	$default	Optional default (or null)

Returns: string|null

Definition at line 440 of file WebRequest.php.

References getGPCVal().

Referenced by FauxRequest\getText(), and getText().

◆ getValueNames()

WebRequest::getValueNames ( $exclude = [] )

Returns the names of all input values excluding those in $exclude.

Parameters

array $exclude

Returns: array

Definition at line 644 of file WebRequest.php.

References getValues().

◆ getValues()

WebRequest::getValues ( )

Extracts the given named values into an array.

If no arguments are given, returns all input values. No transformation is performed on the values.

Returns: array

Reimplemented in FauxRequest.

Definition at line 622 of file WebRequest.php.

References $name, $value, and getGPCVal().

Referenced by getValueNames().

◆ hasSafeMethod()

WebRequest::hasSafeMethod ( )

Check if this request uses a "safe" HTTP method.

Safe methods are verbs (e.g. GET/HEAD/OPTIONS) used for obtaining content. Such requests are not expected to mutate content, especially in ways attributable to the client. Verbs like POST and PUT are typical of non-safe requests which often change content.

Returns: bool

See also: https://tools.ietf.org/html/rfc7231#section-4.2.1; https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html

Since: 1.28

Definition at line 1299 of file WebRequest.php.

◆ initHeaders()

WebRequest::initHeaders ( )

protected

Initialise the header list.

Reimplemented in FauxRequest.

Definition at line 985 of file WebRequest.php.

References $name, and $value.

Referenced by getAllHeaders(), and getHeader().

◆ interpolateTitle()

WebRequest::interpolateTitle ( )

Check for title, action, and/or variant data in the URL and interpolate it into the GET variables.

This should only be run after the content language is available, as we may need the list of language variants to determine available variant URLs.

Definition at line 314 of file WebRequest.php.

References $matches.

◆ isSafeRequest()

WebRequest::isSafeRequest ( )

Whether this request should be identified as being "safe".

This means that the client is not requesting any state changes and that database writes are not inherently required. Ideally, no visible updates would happen at all. If they must, then they should not be publically attributed to the end user.

In more detail:

Cache populations and refreshes MAY occur.
Private user session updates and private server logging MAY occur.
Updates to private viewing activity data MAY occur via DeferredUpdates.
Other updates SHOULD NOT occur (e.g. modifying content assets).

Returns: bool

See also: https://tools.ietf.org/html/rfc7231#section-4.2.1; https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html

Since: 1.28

Definition at line 1325 of file WebRequest.php.

◆ markAsSafeRequest()

WebRequest::markAsSafeRequest ( )

Mark this request as identified as being nullipotent even if it is a POST request.

POST requests are often used due to the need for a client payload, even if the request is otherwise equivalent to a "safe method" request.

See also: https://tools.ietf.org/html/rfc7231#section-4.2.1; https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html

Since: 1.28

Definition at line 1343 of file WebRequest.php.

◆ normalizeUnicode()

WebRequest::normalizeUnicode ( $data )

Recursively normalizes UTF-8 strings in the given array.

Parameters

string | array $data

Returns: array|string Cleaned-up version of the given

Access:\n private

Definition at line 362 of file WebRequest.php.

References $data, and normalizeUnicode().

Referenced by getGPCVal(), and normalizeUnicode().

◆ overrideRequestId()

static WebRequest::overrideRequestId ( $id )

static

Override the unique request ID.

This is for sub-requests, such as jobs, that wish to use the same id but are not part of the same execution context.

Parameters

string $id

Since: 1.27

Definition at line 292 of file WebRequest.php.

◆ response()

WebRequest::response ( )

Return a handle to WebResponse style object, for setting cookies, headers and other stuff, for Request being worked on.

Returns: WebResponse

Reimplemented in MockWebRequest.

Definition at line 973 of file WebRequest.php.

References $response, and response().

Referenced by response().

◆ setIP()

WebRequest::setIP ( $ip )

Parameters

string $ip

Returns: void

Since: 1.21

Definition at line 1283 of file WebRequest.php.

◆ setSessionData()

WebRequest::setSessionData	(		$key,
			$data )

Set session data.

Note: Prefer $this->getSession() instead if making multiple calls.

Parameters

string	$key	Name of key in the session
mixed	$data

Reimplemented in DerivativeRequest.

Definition at line 1060 of file WebRequest.php.

References $data, and getSession().

◆ setSessionId()

WebRequest::setSessionId ( SessionId $sessionId )

Set the session for this request.

Since: 1.27

Access:\n private For use by MediaWiki\Session classes only

Parameters

SessionId $sessionId

Definition at line 761 of file WebRequest.php.

◆ setVal()

WebRequest::setVal	(		$key,
			$value )

Set an arbitrary value into our get/post data.

Parameters

string	$key	Key name to use
mixed	$value	Value to set

Returns: mixed Old value if one was present, null otherwise

Definition at line 459 of file WebRequest.php.

References $ret, and $value.

◆ unsetVal()

WebRequest::unsetVal ( $key )

Unset an arbitrary value from our get/post data.

Parameters

string $key Key name to use

Returns: mixed Old value if one was present, null otherwise

Definition at line 471 of file WebRequest.php.

References $ret.

◆ wasPosted()

WebRequest::wasPosted ( )

Returns true if the present request was reached by a POST operation, false otherwise (GET, HEAD, or command-line).

Note that values retrieved by the object may come from the GET URL etc even on a POST request.

Returns: bool

Reimplemented in FauxRequest.

Definition at line 728 of file WebRequest.php.

References getMethod().

Referenced by checkUrlExtension(), and getRawPostString().

Member Data Documentation

◆ $data

WebRequest::$data

protected

Definition at line 42 of file WebRequest.php.

Referenced by FauxRequest\__construct(), DerivativeRequest\__construct(), getGPCVal(), normalizeUnicode(), DerivativeRequest\setSessionData(), and setSessionData().

◆ $headers

WebRequest::$headers = []

protected

Definition at line 42 of file WebRequest.php.

◆ $ip

string WebRequest::$ip

private

Cached client IP address.

Definition at line 66 of file WebRequest.php.

◆ $markedAsSafe

bool WebRequest::$markedAsSafe = false

protected

Whether this HTTP request is "safe" (even if it is an HTTP post)

Definition at line 88 of file WebRequest.php.

◆ $protocol

string WebRequest::$protocol

protected

Cached URL protocol.

Definition at line 78 of file WebRequest.php.

Referenced by FauxRequest\__construct().

◆ $reqId

string WebRequest::$reqId

staticprivate

The unique request ID.

Definition at line 54 of file WebRequest.php.

◆ $requestTime

float WebRequest::$requestTime

protected

The timestamp of the start of the request, with microsecond precision.

Definition at line 72 of file WebRequest.php.

◆ $response

WebResponse WebRequest::$response

private

Lazy-init response object.

Definition at line 60 of file WebRequest.php.

◆ $sessionId

SessionId null WebRequest::$sessionId = null

protected

Session ID to use for this request.

We can't save the session directly due to reference cycles not working too well (slow GC in Zend and never collected in HHVM).

Definition at line 85 of file WebRequest.php.

◆ GETHEADER_LIST

const WebRequest::GETHEADER_LIST = 1

Flag to make WebRequest::getHeader return an array of values.

Since: 1.26

Definition at line 48 of file WebRequest.php.

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

includes/WebRequest.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ appendQueryArray()

◆ appendQueryValue()

◆ checkUrlExtension()

◆ detectProtocol()

◆ detectServer()

◆ doSecurityRedirect()

◆ extractTitle()

◆ getAcceptLang()

◆ getAllHeaders()

◆ getArray()

◆ getBool()

◆ getCheck()

◆ getCookie()

◆ getElapsedTime()

◆ getFileName()

◆ getFileTempname()

◆ getFloat()

◆ getFullRequestURL()

◆ getFuzzyBool()

◆ getGlobalRequestURL()

◆ getGPCVal()

◆ getHeader()

◆ getInt()

◆ getIntArray()

◆ getIntOrNull()

◆ getIP()

◆ getLimitOffset()

◆ getMethod()

◆ getPathInfo()

◆ getPostValues()

◆ getProtocol()

◆ getQueryValues()

◆ getRawInput()

◆ getRawIP()

◆ getRawPostString()

◆ getRawQueryString()

◆ getRawVal()

◆ getRequestId()

◆ getRequestURL()

◆ getSession()

◆ getSessionData()

◆ getSessionId()

◆ getText()

◆ getUpload()

◆ getUploadError()

◆ getVal()

◆ getValueNames()

◆ getValues()

◆ hasSafeMethod()

◆ initHeaders()

◆ interpolateTitle()

◆ isSafeRequest()

◆ markAsSafeRequest()

◆ normalizeUnicode()

◆ overrideRequestId()

◆ response()

◆ setIP()

◆ setSessionData()

◆ setSessionId()

◆ setVal()

◆ unsetVal()

◆ wasPosted()

Member Data Documentation

◆ $data

◆ $headers

◆ $ip

◆ $markedAsSafe

◆ $protocol