MediaWiki REL1_28
GlobalFunctions.php File Reference

Global functions used everywhere. More...

Go to the source code of this file.

Functions

 mimeTypeMatch ( $type, $avail)
 Checks if a given MIME type matches any of the keys in the given array.
 
 wfAcceptToPrefs ( $accept, $def=' */*')
 Converts an Accept-* header into an array mapping string values to quality factors.
 
 wfAppendQuery ( $url, $query)
 Append a query string to an existing URL, which may or may not already have query string parameters already.
 
 wfAppendToArrayIfNotDefault ( $key, $value, $default, &$changed)
 Appends to second array if $value differs from that in $default.
 
 wfArrayDiff2 ( $a, $b)
 Like array_diff( $a, $b ) except that it works with two-dimensional arrays.
 
 wfArrayDiff2_cmp ( $a, $b)
 
 wfArrayInsertAfter (array $array, array $insert, $after)
 Insert array into another array after the specified KEY
 
 wfArrayPlus2d (array $baseArray, array $newValues)
 Merges two (possibly) 2 dimensional arrays into the target array ($baseArray).
 
 wfArrayToCgi ( $array1, $array2=null, $prefix='')
 This function takes one or two arrays as input, and returns a CGI-style string, e.g.
 
 wfAssembleUrl ( $urlParts)
 This function will reassemble a URL parsed with wfParseURL.
 
 wfBacktrace ( $raw=null)
 Get a debug backtrace as a string.
 
 wfBaseConvert ( $input, $sourceBase, $destBase, $pad=1, $lowercase=true, $engine='auto')
 Convert an arbitrarily-long digit string from one numeric base to another, optionally zero-padding to a minimum column width.
 
 wfBaseName ( $path, $suffix='')
 Return the final portion of a pathname.
 
 wfBCP47 ( $code)
 Get the normalised IETF language tag See unit test for examples.
 
 wfBoolToStr ( $value)
 Convenience function converts boolean values into "true" or "false" (string) values.
 
 wfCanIPUseHTTPS ( $ip)
 Determine whether the client at a given source IP is likely to be able to access the wiki via HTTPS.
 
 wfCgiToArray ( $query)
 This is the logical opposite of wfArrayToCgi(): it accepts a query string as its argument and returns the same string in array form.
 
 wfClearOutputBuffers ()
 More legible than passing a 'false' parameter to wfResetOutputBuffers():
 
 wfClientAcceptsGzip ( $force=false)
 
 wfConfiguredReadOnlyReason ()
 Get the value of $wgReadOnly or the contents of $wgReadOnlyFile.
 
 wfCountDown ( $seconds)
 Count down from $seconds to zero on the terminal, with a one-second pause between showing each number.
 
 wfDebug ( $text, $dest='all', array $context=[])
 Sends a line to the debug log if enabled or, optionally, to a comment in output.
 
 wfDebugBacktrace ( $limit=0)
 Safety wrapper for debug_backtrace().
 
 wfDebugLog ( $logGroup, $text, $dest='all', array $context=[])
 Send a line to a supplementary debug log file, if configured, or main debug log if not.
 
 wfDebugMem ( $exact=false)
 Send a line giving PHP memory usage.
 
 wfDeprecated ( $function, $version=false, $component=false, $callerOffset=2)
 Throws a warning that $function is deprecated.
 
 wfDiff ( $before, $after, $params='-u')
 Returns unified plain-text diff of two texts.
 
 wfErrorLog ( $text, $file, array $context=[])
 Log to a file without getting "file size exceeded" signals.
 
 wfEscapeShellArg ()
 Version of escapeshellarg() that works better on Windows.
 
 wfEscapeWikiText ( $text)
 Escapes the given text so that it may be output using addWikiText() without any linking, formatting, etc.
 
 wfExpandIRI ( $url)
 Take a URL, make sure it's expanded to fully qualified, and replace any encoded non-ASCII Unicode characters with their UTF-8 original forms for more compact display and legibility for local audiences.
 
 wfExpandIRI_callback ( $matches)
 Private callback for wfExpandIRI.
 
 wfExpandUrl ( $url, $defaultProto=PROTO_CURRENT)
 Expand a potentially local URL to a fully-qualified URL.
 
 wfFindFile ( $title, $options=[])
 Find a file.
 
 wfFixSessionID ()
 
 wfForeignMemcKey ( $db, $prefix)
 Make a cache key for a foreign DB.
 
 wfFormatStackFrame ( $frame)
 Return a string representation of frame.
 
 wfGetAllCallers ( $limit=3)
 Return a string consisting of callers in the stack.
 
 wfGetCache ( $cacheType)
 Get a specific cache object.
 
 wfGetCaller ( $level=2)
 Get the name of the function which called this function wfGetCaller( 1 ) is the function with the wfGetCaller() call (ie.
 
 wfGetDB ( $db, $groups=[], $wiki=false)
 Get a Database object.
 
 wfGetLangObj ( $langcode=false)
 Return a Language object from $langcode.
 
 wfGetLB ( $wiki=false)
 Get a load balancer object.
 
 wfGetLBFactory ()
 Get the load balancer factory object.
 
 wfGetMainCache ()
 Get the main cache object.
 
 wfGetMessageCacheStorage ()
 Get the cache object used by the message cache.
 
 wfGetNull ()
 Get a platform-independent path to the null file, e.g.
 
 wfGetParserCacheStorage ()
 Get the cache object used by the parser cache.
 
 wfGetPrecompiledData ( $name)
 Get an object from the precompiled serialized directory.
 
 wfGetScriptUrl ()
 Get the script URL.
 
 wfGlobalCacheKey ()
 Make a cache key with database-agnostic prefix.
 
 wfHostname ()
 Fetch server name for use in error reporting etc.
 
 wfHttpError ( $code, $label, $desc)
 Provide a simple HTTP error.
 
 wfIncrStats ( $key, $count=1)
 Increment a statistics counter.
 
 wfIniGetBool ( $setting)
 Safety wrapper around ini_get() for boolean settings.
 
 wfInitShellLocale ()
 Workaround for http://bugs.php.net/bug.php?id=45132 escapeshellarg() destroys non-ASCII characters if LANG is not a UTF-8 locale.
 
 wfIsBadImage ( $name, $contextTitle=false, $blacklist=null)
 Determine if an image exists on the 'bad image list'.
 
 wfIsDebugRawPage ()
 Returns true if debug logging should be suppressed if $wgDebugRawPage = false.
 
 wfIsHHVM ()
 Check if we are running under HHVM.
 
 wfIsInfinity ( $str)
 Determine input string is represents as infinity.
 
 wfIsWindows ()
 Check if the operating system is Windows.
 
 wfLoadExtension ( $ext, $path=null)
 Load an extension.
 
 wfLoadExtensions (array $exts)
 Load multiple extensions at once.
 
 wfLoadSkin ( $skin, $path=null)
 Load a skin.
 
 wfLoadSkins (array $skins)
 Load multiple skins at once.
 
 wfLocalFile ( $title)
 Get an object referring to a locally registered file.
 
 wfLogDBError ( $text, array $context=[])
 Log for database errors.
 
 wfLogProfilingData ()
 
 wfLogWarning ( $msg, $callerOffset=1, $level=E_USER_WARNING)
 Send a warning as a PHP error and the debug log.
 
 wfMakeUrlIndexes ( $url)
 Make URL indexes, appropriate for the el_index field of externallinks.
 
 wfMatchesDomainList ( $url, $domains)
 Check whether a given URL has a domain that occurs in a given set of domains.
 
 wfMemcKey ()
 Make a cache key for the local wiki.
 
 wfMemoryLimit ()
 Set PHP's memory limit to the larger of php.ini or $wgMemoryLimit.
 
 wfMerge ( $old, $mine, $yours, &$result)
 wfMerge attempts to merge differences between three texts.
 
 wfMergeErrorArrays ()
 Merge arrays in the style of getUserPermissionsErrors, with duplicate removal e.g.
 
 wfMessage ( $key)
 This is the function for getting translated interface messages.
 
 wfMessageFallback ()
 This function accepts multiple message keys and returns a message instance for the first message which is non-empty.
 
 wfMkdirParents ( $dir, $mode=null, $caller=null)
 Make directory, and make all parent directories if they don't exist.
 
 wfMsgReplaceArgs ( $message, $args)
 Replace message parameter keys on the given formatted output.
 
 wfNegotiateType ( $cprefs, $sprefs)
 Returns the 'best' match between a client's requested internet media types and the server's list of available types.
 
 wfObjectToArray ( $objOrArray, $recursive=true)
 Recursively converts the parameter (an object) to an array with the same data.
 
 wfParseUrl ( $url)
 parse_url() work-alike, but non-broken.
 
 wfPercent ( $nr, $acc=2, $round=true)
 
 wfQueriesMustScale ()
 Should low-performance queries be disabled?
 
 wfRandom ()
 Get a random decimal value between 0 and 1, in a way not likely to give duplicate values for any realistic number of articles.
 
 wfRandomString ( $length=32)
 Get a random string containing a number of pseudo-random hex characters.
 
 wfReadOnly ()
 Check whether the wiki is in read-only mode.
 
 wfReadOnlyReason ()
 Check if the site is in read-only mode and return the message if so.
 
 wfRecursiveRemoveDir ( $dir)
 Remove a directory and all its content.
 
 wfRelativePath ( $path, $from)
 Generate a relative path name to the given file.
 
 wfRemoveDotSegments ( $urlPath)
 Remove all dot-segments in the provided URL path.
 
 wfReportTime ()
 Returns a script tag that stores the amount of time it took MediaWiki to handle the request in milliseconds as 'wgBackendResponseTime'.
 
 wfResetOutputBuffers ( $resetGzipEncoding=true)
 Clear away any user-level output buffers, discarding contents.
 
 wfResetSessionID ()
 Reset the session id.
 
 wfRestoreWarnings ()
 
 wfRunHooks ( $event, array $args=[], $deprecatedVersion=null)
 Call hook functions defined in $wgHooks.
 
 wfScript ( $script='index')
 Get the path to a specified script file, respecting file extensions; this is a wrapper around $wgScriptPath etc.
 
 wfSetBit (&$dest, $bit, $state=true)
 As for wfSetVar except setting a bit.
 
 wfSetupSession ( $sessionId=false)
 Initialise php session.
 
 wfSetVar (&$dest, $source, $force=false)
 Sets dest to source and returns the original value of dest If source is NULL, it just returns the value, it doesn't set the variable If force is true, it will set the value even if source is NULL.
 
 wfShellExec ( $cmd, &$retval=null, $environ=[], $limits=[], $options=[])
 Execute a shell command, with time and memory limits mirrored from the PHP configuration if supported.
 
 wfShellExecDisabled ()
 Check if wfShellExec() is effectively disabled via php.ini config.
 
 wfShellExecWithStderr ( $cmd, &$retval=null, $environ=[], $limits=[])
 Execute a shell command, returning both stdout and stderr.
 
 wfShellWikiCmd ( $script, array $parameters=[], array $options=[])
 Generate a shell-escaped command line string to run a MediaWiki cli script.
 
 wfShorthandToInteger ( $string='', $default=-1)
 Converts shorthand byte notation to integer form.
 
 wfShowingResults ( $offset, $limit)
 
 wfSplitWikiID ( $wiki)
 Split a wiki ID into DB name and table prefix.
 
 wfStripIllegalFilenameChars ( $name)
 Replace all invalid characters with '-'.
 
 wfSuppressWarnings ( $end=false)
 Reference-counted warning suppression.
 
 wfTempDir ()
 Tries to get the system directory for temporary files.
 
 wfThumbIsStandard (File $file, array $params)
 Returns true if these thumbnail parameters match one that MediaWiki requests from file description pages and/or parser output.
 
 wfTimestamp ( $outputtype=TS_UNIX, $ts=0)
 Get a timestamp string in one of various formats.
 
 wfTimestampNow ()
 Convenience function; returns MediaWiki timestamp for the present time.
 
 wfTimestampOrNull ( $outputtype=TS_UNIX, $ts=null)
 Return a formatted timestamp, or null if input is null.
 
 wfTransactionalTimeLimit ()
 Set PHP's time limit to the larger of php.ini or $wgTransactionalTimeLimit.
 
 wfUnpack ( $format, $data, $length=false)
 Wrapper around php's unpack.
 
 wfUrlencode ( $s)
 We want some things to be included as literal characters in our title URLs for prettiness, which urlencode encodes by default.
 
 wfUrlProtocols ( $includeProtocolRelative=true)
 Returns a regular expression of url protocols.
 
 wfUrlProtocolsWithoutProtRel ()
 Like wfUrlProtocols(), but excludes '//' from the protocol list.
 
 wfUseMW ( $req_ver)
 This function works like "use VERSION" in Perl except it checks the version of MediaWiki, the program will die with a backtrace if the current version of MediaWiki is less than the version provided.
 
 wfUsePHP ( $req_ver)
 This function works like "use VERSION" in Perl, the program will die with a backtrace if the current version of PHP is less than the version provided.
 
 wfVarDump ( $var)
 A wrapper around the PHP function var_export().
 
 wfWaitForSlaves ( $ifWritesSince=null, $wiki=false, $cluster=false, $timeout=null)
 Waits for the replica DBs to catch up to the master position.
 
 wfWarn ( $msg, $callerOffset=1, $level=E_USER_NOTICE)
 Send a warning either to the debug log or in a PHP error depending on $wgDevelopmentWarnings.
 
 wfWikiID ()
 Get an ASCII string identifying this wiki This is used as a prefix in memcached keys.
 

Detailed Description

Global functions used everywhere.

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

Definition in file GlobalFunctions.php.

Function Documentation

◆ mimeTypeMatch()

mimeTypeMatch (   $type,
  $avail 
)

Checks if a given MIME type matches any of the keys in the given array.

Basic wildcards are accepted in the array keys.

Returns the matching MIME type (or wildcard) if a match, otherwise NULL if no match.

Parameters
string$type
array$avail
Returns
string
Access:\n private

Definition at line 1914 of file GlobalFunctions.php.

References $type.

Referenced by GlobalTest\testMimeTypeMatch(), and wfNegotiateType().

◆ wfAcceptToPrefs()

wfAcceptToPrefs (   $accept,
  $def = '*/*' 
)

Converts an Accept-* header into an array mapping string values to quality factors.

Parameters
string$accept
string$defDefault
Returns
float[] Associative array of string => float pairs

Definition at line 1878 of file GlobalFunctions.php.

References as.

◆ wfAppendQuery()

◆ wfAppendToArrayIfNotDefault()

wfAppendToArrayIfNotDefault (   $key,
  $value,
  $default,
$changed 
)

Appends to second array if $value differs from that in $default.

Parameters
string | int$key
mixed$value
mixed$default
array$changedArray to alter
Exceptions
MWException

Definition at line 213 of file GlobalFunctions.php.

References $value.

◆ wfArrayDiff2()

wfArrayDiff2 (   $a,
  $b 
)

Like array_diff( $a, $b ) except that it works with two-dimensional arrays.

Parameters
array$a
array$b
Returns
array

Definition at line 177 of file GlobalFunctions.php.

Referenced by WikiPage\doRollback(), EditPage\getEditPermissionErrors(), GlobalTest\testWfArrayDiff2(), and UploadBase\verifyTitlePermissions().

◆ wfArrayDiff2_cmp()

wfArrayDiff2_cmp (   $a,
  $b 
)
Parameters
array | string$a
array | string$b
Returns
int

Definition at line 186 of file GlobalFunctions.php.

References list.

◆ wfArrayInsertAfter()

wfArrayInsertAfter ( array  $array,
array  $insert,
  $after 
)

Insert array into another array after the specified KEY

Parameters
array$arrayThe array.
array$insertThe array to insert.
mixed$afterThe key to insert after
Returns
array

Definition at line 268 of file GlobalFunctions.php.

References $keys, and $output.

Referenced by DeletedContributionsPage\getSubTitle().

◆ wfArrayPlus2d()

wfArrayPlus2d ( array  $baseArray,
array  $newValues 
)

Merges two (possibly) 2 dimensional arrays into the target array ($baseArray).

Values that exist in both values will be combined with += (all values of the array of $newValues will be added to the values of the array of $baseArray, while values, that exists in both, the value of $baseArray will be used).

Parameters
array$baseArrayThe array where you want to add the values of $newValues to
array$newValuesAn array with new values
Returns
array The combined array
Since
1.26

Definition at line 3696 of file GlobalFunctions.php.

References $name, and as.

Referenced by ExtensionRegistry\exportExtractedData(), and WfArrayPlus2dTest\testWfArrayPlus2d().

◆ wfArrayToCgi()

◆ wfAssembleUrl()

wfAssembleUrl (   $urlParts)

This function will reassemble a URL parsed with wfParseURL.

This is useful if you need to edit part of a URL and put it back together.

This is the basic structure used (brackets contain keys for $urlParts): [scheme][delimiter][user]:[pass]@[host]:[port][path]?[query]#[fragment]

Todo:
Need to integrate this into wfExpandUrl (see T34168)
Since
1.19
Parameters
array$urlPartsURL parts, as output from wfParseUrl
Returns
string URL assembled from its component parts

Definition at line 627 of file GlobalFunctions.php.

Referenced by WfAssembleUrlTest\testWfAssembleUrl(), and wfExpandUrl().

◆ wfBacktrace()

wfBacktrace (   $raw = null)

Get a debug backtrace as a string.

Parameters
bool | null$rawIf true, the return value is plain text. If false, HTML. Defaults to $wgCommandLineMode if unset.
Returns
string
Since
1.25 Supports $raw parameter.

Definition at line 1537 of file GlobalFunctions.php.

References $line, $wgCommandLineMode, global, use, and wfDebugBacktrace().

Referenced by MWDebug\deprecated().

◆ wfBaseConvert()

wfBaseConvert (   $input,
  $sourceBase,
  $destBase,
  $pad = 1,
  $lowercase = true,
  $engine = 'auto' 
)

Convert an arbitrarily-long digit string from one numeric base to another, optionally zero-padding to a minimum column width.

Supports base 2 through 36; digit values 10-36 are represented as lowercase letters a-z. Input is case-insensitive.

Deprecated:
since 1.27 Use Wikimedia\base_convert() directly
Parameters
string$inputInput number
int$sourceBaseBase of the input number
int$destBaseDesired base of the output
int$padMinimum number of digits in the output (pad with zeroes)
bool$lowercaseWhether to output in lowercase or uppercase
string$engineEither "gmp", "bcmath", or "php"
Returns
string|bool The output number as a string, or false on error

Definition at line 2889 of file GlobalFunctions.php.

References $engine.

◆ wfBaseName()

wfBaseName (   $path,
  $suffix = '' 
)

Return the final portion of a pathname.

Reimplemented because PHP5's "basename()" is buggy with multibyte text. http://bugs.php.net/bug.php?id=33898

PHP's basename() only considers '\' a pathchar on Windows and Netware. We'll consider it so always, as we don't want '\s' in our Unix paths either.

Parameters
string$path
string$suffixString to remove if present
Returns
string

Definition at line 2812 of file GlobalFunctions.php.

References $matches, and $path.

Referenced by Exif\__construct(), ImageBuilder\checkMissingImage(), TestFileOpPerformance\doPerfTest(), WfBaseNameTest\testBaseName(), wfRelativePath(), and wfStripIllegalFilenameChars().

◆ wfBCP47()

wfBCP47 (   $code)

Get the normalised IETF language tag See unit test for examples.

Parameters
string$codeThe language code.
Returns
string The language code which complying with BCP 47 standards.

Definition at line 3384 of file GlobalFunctions.php.

References $code, and as.

Referenced by OutputPage\addAcceptLanguage(), SkinTemplate\buildContentNavigationUrls(), ImagePage\doRenderLangOpt(), WebInstallerOutput\getHeadAttribs(), OutputPage\getHeadLinksArray(), Language\getHtmlCode(), FeedItem\getLanguage(), SkinTemplate\getLanguages(), CoreParserFunctions\language(), Preferences\profilePreferences(), and WfBCP47Test\testBCP47().

◆ wfBoolToStr()

wfBoolToStr (   $value)

Convenience function converts boolean values into "true" or "false" (string) values.

Parameters
bool$value
Returns
string

Definition at line 3193 of file GlobalFunctions.php.

References $value.

Referenced by ApiRsd\formatRsdApiList(), MysqlInstaller\getLocalSettings(), and GlobalTest\testClientAcceptsGzipTest().

◆ wfCanIPUseHTTPS()

wfCanIPUseHTTPS (   $ip)

Determine whether the client at a given source IP is likely to be able to access the wiki via HTTPS.

Parameters
string$ipThe IPv4/6 address in the normal human-readable form
Returns
bool

Definition at line 3578 of file GlobalFunctions.php.

Referenced by LoginSignupSpecialPage\execute(), Preferences\profilePreferences(), and User\requiresHTTPS().

◆ wfCgiToArray()

wfCgiToArray (   $query)

This is the logical opposite of wfArrayToCgi(): it accepts a query string as its argument and returns the same string in array form.

This allows compatibility with legacy functions that accept raw query strings instead of nice arrays. Of course, keys and values are urldecode()d.

Parameters
string$queryQuery string
Returns
string[] Array version of input

Definition at line 452 of file GlobalFunctions.php.

References $keys, $query, $ret, $value, as, and list.

Referenced by Linker\link(), Linker\makeBrokenImageLinkObj(), SpecialChangeEmail\onSuccess(), OutputPage\returnToMain(), LoginHelper\showReturnToPage(), SpecialCreateAccount\successfulAction(), GlobalTest\testCgiRoundTrip(), and GlobalTest\testCgiToArray().

◆ wfClearOutputBuffers()

wfClearOutputBuffers ( )

More legible than passing a 'false' parameter to wfResetOutputBuffers():

Clear away output buffers, but keep the Content-Encoding header produced by ob_gzhandler, if any.

This should be used for HTTP 304 responses, where you need to preserve the Content-Encoding header of the real result, but also need to suppress the output of ob_gzhandler to keep to spec and avoid breaking Firefox in rare cases where the headers and body are broken over two packets.

Definition at line 1866 of file GlobalFunctions.php.

References wfResetOutputBuffers().

Referenced by ApiMain\checkConditionalRequestHeaders(), and OutputPage\checkLastModified().

◆ wfClientAcceptsGzip()

wfClientAcceptsGzip (   $force = false)
Todo:

document

FIXME: We may want to blacklist some broken browsers

Parameters
bool$force
Returns
bool Whereas client accept gzip compression

Definition at line 1634 of file GlobalFunctions.php.

References wfDebug().

Referenced by HTMLFileCache\loadFromFileCache(), HTMLFileCache\saveToFileCache(), GlobalTest\testClientAcceptsGzipTest(), and wfGzipHandler().

◆ wfConfiguredReadOnlyReason()

wfConfiguredReadOnlyReason ( )

Get the value of $wgReadOnly or the contents of $wgReadOnlyFile.

Returns
string|bool String when in read-only mode; false otherwise
Since
1.27

Definition at line 1308 of file GlobalFunctions.php.

References $wgReadOnly, $wgReadOnlyFile, and global.

Referenced by MWLBFactory\applyDefaultConfig(), FileBackendGroup\initFromGlobals(), JobQueueGroup\singleton(), and wfReadOnlyReason().

◆ wfCountDown()

wfCountDown (   $seconds)

Count down from $seconds to zero on the terminal, with a one-second pause between showing each number.

For use in command-line scripts.

Parameters
int$seconds

Definition at line 3264 of file GlobalFunctions.php.

Referenced by ResetUserTokens\execute(), UpdateMediaWiki\execute(), and UserOptions\warn().

◆ wfDebug()

wfDebug (   $text,
  $dest = 'all',
array  $context = [] 
)

Sends a line to the debug log if enabled or, optionally, to a comment in output.

In normal operation this is a NOP.

Controlling globals: $wgDebugLogFile - points to the log file $wgDebugRawPage - if false, 'action=raw' hits will not result in debug output. $wgDebugComments - if on, some debug items may appear in comments in the HTML output.

Since
1.25 support for additional context data
Parameters
string$text
string | bool$destDestination of the message:
  • 'all': both to the log and HTML (debug toolbar or HTML comments)
  • 'private': excluded from HTML output For backward compatibility, it can also take a boolean:
  • true: same as 'all'
  • false: same as 'private'
array$contextAdditional logging context data

Definition at line 998 of file GlobalFunctions.php.

References $context, $wgDebugLogPrefix, $wgDebugRawPage, $wgDebugTimestamps, $wgRequestTime, global, and wfIsDebugRawPage().

Referenced by Parser\__construct(), ApiMain\__construct(), DifferenceEngine\__construct(), SearchUpdate\__construct(), UploadStashFile\__construct(), Revision\__construct(), PageArchive\__construct(), UploadFromStash\__construct(), QuickTemplate\__construct(), UploadFromChunks\__construct(), StubObject\_unstub(), LogPage\actionText(), ImageGalleryBase\add(), ParserTestRunner\addArticle(), MediaHandler\addMeta(), LinkBatch\addObj(), LocalFileMoveBatch\addOlds(), ParserOutput\addTrackingCategory(), Skin\afterContentHook(), Parser\braceSubstitution(), SkinTemplate\buildContentActionUrls(), EmailNotification\canSendUserTalkEmail(), AjaxResponse\checkLastModified(), OutputPage\checkLastModified(), UploadBase\checkSvgScriptCallback(), UploadBase\checkXMLEncodingMissmatch(), JobQueueDB\claimOldest(), LocalRepo\cleanupDeletedBatch(), UploadBase\cleanupTempFile(), SpecialEditWatchlist\cleanupWatchlist(), UploadStash\clear(), CloneDatabase\cloneTableStructure(), Revision\compressRevisionText(), UploadFromChunks\concatenateChunks(), Article\confirmDelete(), DjVuImage\convertDumpToXML(), UploadBase\createFromRequest(), WikiImporter\debug(), SVGReader\debug(), RecompressTracked\debug(), SectionProfiler\debug(), BaseDump\debug(), Block\defaultRetroactiveAutoblock(), Article\delete(), Block\deleteIfExpired(), User\deleteNewtalk(), ChangeTags\deleteTagEverywhere(), UploadBase\detectScript(), UploadBase\detectVirus(), DiffEngine\diffInternal(), Parser\disableCache(), BitmapMetadataHandler\doApp13(), Block\doAutoblock(), JobQueueDB\doBatchPushInternal(), WikiPage\doDeleteArticleReal(), WikiPage\doEditUpdates(), MockImageHandler\doFakeTransform(), WikiFilePage\doPurge(), DatabaseMssql\doQuery(), DatabaseOracle\doQuery(), Block\doRetroactiveAutoblock(), UserrightsPage\doSaveUserGroups(), DjVuHandler\doTransform(), TransformationalImageHandler\doTransform(), WikiRevision\downloadSource(), EditPage\edit(), ZipDirectoryReader\error(), ChangesFeed\execute(), SpecialUpload\execute(), SpecialUserLogout\execute(), ApiUpload\execute(), LocalFileRestoreBatch\execute(), PoolWorkArticleView\fallback(), Article\fetchContentObject(), IcuCollation\fetchFirstLetterData(), DatabaseMssql\fieldExists(), DatabaseMssql\fieldInfo(), DiffEngine\find_middle_snake(), BlockLevelPass\findColonNoLinks(), WikiImporter\finishImportPage(), FormatMetadata\flattenArrayReal(), ContribsPager\formatRow(), DeletedContribsPager\formatRow(), FileRepo\freeTemp(), ParserCache\get(), LCStoreCDB\get(), MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached(), User\getBlockedStatus(), CoreParserFunctions\getCachedRevisionObject(), PoolWorkArticleView\getCachedWork(), Action\getContext(), ContextSource\getContext(), Article\getContext(), Profiler\getContext(), SpecialPage\getContext(), SpecialVersion\getCreditsForExtension(), File\getDescriptionText(), ForeignDBFile\getDescriptionText(), UploadStash\getFile(), DoubleRedirectJob\getFinalDestination(), WikiFilePage\getForeignCategories(), GenderCache\getGenderOf(), MediaHandlerFactory\getHandler(), DjVuImage\getInfo(), SpecialUpload\getInitialPageText(), MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry(), ParserCache\getKey(), ResourceLoaderContext\getLanguage(), TransformationalImageHandler\getMagickVersion(), RequestContext\getMainAndWarn(), SvgHandler\getMetadata(), GIFMetadataExtractor\getMetadata(), PNGMetadataExtractor\getMetadata(), GIFHandler\getMetadata(), JpegHandler\getMetadata(), PNGHandler\getMetadata(), TiffHandler\getMetadata(), DjVuHandler\getMetadata(), DjVuHandler\getMetaTree(), DjVuImage\getMultiPageInfo(), WebRequestUpload\getName(), Title\getNsText(), DjVuImage\getPageInfo(), WikiPage\getParserOutput(), SpecialEmailUser\getPermissionsError(), EditPage\getPreloadedContent(), UserCache\getProp(), Title\getRestrictionTypes(), ExternalStoreDB\getSlave(), SpecialEmailUser\getTarget(), ForeignAPIRepo\getThumbError(), ForeignAPIRepo\getThumbUrl(), UploadStashFile\getThumbUrl(), ForeignAPIRepo\getThumbUrlFromCache(), Title\getTitleValue(), Parser\getUserSig(), Parser\getVariableValue(), File\getViewURL(), XCFHandler\getXCFMetaData(), OutputPage\haveCacheVaryCookies(), ThumbnailRenderJob\hitThumbUrl(), ForeignAPIRepo\httpGet(), EditPage\importFormData(), WikiRevision\importLogItem(), WikiRevision\importOldRevision(), WikiRevision\importUpload(), Block\insert(), ExternalStore\insertWithFallback(), EditPage\internalAttemptSave(), User\isBlockedFrom(), FileCacheBase\isCacheGood(), DjVuHandler\isEnabled(), SvgHandler\isEnabled(), LocalisationCache\isExpired(), Block\isExpired(), FileDependency\isExpired(), ExifBitmapHandler\isMetadataValid(), GIFHandler\isMetadataValid(), PNGHandler\isMetadataValid(), WebPHandler\isMetadataValid(), Title\isValidMoveTarget(), MovePage\isValidMoveTarget(), Block\isWhitelistedFromAutoblocks(), MessageCache\load(), SiteStats\loadAndLazyInit(), ChangesFeed\loadFromCache(), User\loadFromCache(), HTMLFileCache\loadFromFileCache(), AjaxResponse\loadFromMemcached(), User\loadOptions(), Linker\makeExternalImage(), Linker\makeExternalLink(), Linker\makeImageLink(), Linker\makeMediaLinkFile(), ImportStreamSource\newFromURL(), RawAction\onView(), UploadDumper\outputItem(), ApiBase\parseMsg(), SearchMySQL\parseQuery(), SearchSqlite\parseQuery(), SearchPostgres\parseQuery(), BacklinkCache\partition(), DiffHistoryBlob\patch(), AjaxDispatcher\performAction(), ApiUpload\performStash(), User\pingLimiter(), MediaWiki\preOutputCommit(), SkinTemplate\prepareQuickTemplate(), SpecialUpload\processUpload(), LocalFile\purgeThumbList(), BacklinkCache\queryLinks(), SvgHandler\rasterize(), TextPassDumper\readDump(), LocalisationCache\recache(), LocalFile\recordUpload2(), UploadStash\removeFileNoAuth(), Parser\renderImageGallery(), WikiPage\replaceSectionAtRev(), Parser\replaceVariables(), Http\request(), MediaWiki\restInPeace(), DjVuImage\retrieveMetaData(), BitmapHandler\rotate(), JpegHandler\rotate(), DoubleRedirectJob\run(), ThumbnailRenderJob\run(), ParserTestRunner\runTest(), RequestContext\sanitizeLangCode(), ParserCache\save(), FileCacheBase\saveText(), HTMLFileCache\saveToFileCache(), SearchPostgres\searchQuery(), JpegMetadataExtractor\segmentSplitter(), UserMailer\send(), OutputPage\sendCacheControl(), UserMailer\sendInternal(), UserMailer\sendWithPear(), ApiMain\setCacheMode(), LanguageClassesTestCase\setUp(), ParserTestTopLevelSuite\setUp(), UploadFromUrlTestSuite\setupUploadDir(), ViewAction\show(), LocalRepo\skipWriteOperationIfSha1(), User\spreadBlock(), UploadStash\stashFile(), FileRepo\storeBatch(), DatabaseMssql\tableExists(), ParserTestTopLevelSuite\tearDown(), ParserTestRunner\teardownDatabase(), GlobalTest\testDebugFunctionTest(), ApiUploadTest\testUploadChunks(), WikiImporter\throwXmlError(), SVGReader\throwXmlError(), MediaWiki\Tidy\RaggettBase\tidy(), File\transform(), BitmapHandler\transformCustom(), BitmapHandler\transformGd(), BitmapHandler\transformImageMagick(), BitmapHandler\transformImageMagickExt(), LocalisationCacheBulkLoad\trimCache(), SpecialUploadStash\tryClearStashedUploads(), Article\tryFileCache(), PageArchive\undelete(), PageArchive\undeleteRevisions(), Block\update(), UploadFromChunks\updateChunkStatus(), User\updateNewtalk(), LocalFile\upgradeRow(), OldLocalFile\upgradeRow(), HTMLFileCache\useFileCache(), LogEventsList\userCanBitfield(), Revision\userCanBitfield(), SvgHandler\validateParam(), ImageHandler\validateThumbParams(), UploadBase\verifyExtension(), UploadBase\verifyFile(), UploadBase\verifyMimeType(), Article\view(), WikiImporter\warn(), wfClientAcceptsGzip(), wfDebugBacktrace(), wfDebugMem(), wfDiff(), wfGetLangObj(), wfGzipHandler(), wfMemoryLimit(), wfMerge(), wfMkdirParents(), wfRecursiveRemoveDir(), wfShellExec(), wfShellExecDisabled(), and wfTimestamp().

◆ wfDebugBacktrace()

wfDebugBacktrace (   $limit = 0)

Safety wrapper for debug_backtrace().

Will return an empty array if debug_backtrace is disabled, otherwise the output from debug_backtrace() (trimmed).

Parameters
int$limitThis parameter can be used to limit the number of stack frames returned
Returns
array Array of backtrace information

Definition at line 1509 of file GlobalFunctions.php.

References $limit, and wfDebug().

Referenced by MWDebug\getCallerDescription(), wfBacktrace(), wfGetAllCallers(), and wfGetCaller().

◆ wfDebugLog()

wfDebugLog (   $logGroup,
  $text,
  $dest = 'all',
array  $context = [] 
)

Send a line to a supplementary debug log file, if configured, or main debug log if not.

To configure a supplementary log file, set $wgDebugLogGroups[$logGroup] to a string filename or an associative array mapping 'destination' to the desired filename. The associative array may also contain a 'sample' key with an integer value, specifying a sampling factor. Sampled log events will be emitted with a 1 in N random chance.

Since
1.23 support for sampling log messages via $wgDebugLogGroups.
1.25 support for additional context data
1.25 sample behavior dependent on configured $wgMWLoggerDefaultSpi
Parameters
string$logGroup
string$text
string | bool$destDestination of the message:
  • 'all': both to the log and HTML (debug toolbar or HTML comments)
  • 'private': only to the specific log if set in $wgDebugLogGroups and discarded otherwise For backward compatibility, it can also take a boolean:
  • true: same as 'all'
  • false: same as 'private'
array$contextAdditional logging context data

Definition at line 1091 of file GlobalFunctions.php.

References $context.

Referenced by LocalisationCache\__construct(), GitInfo\__construct(), MediaWikiPHPUnitTestListener\addError(), MediaWikiPHPUnitTestListener\addFailure(), MediaWikiPHPUnitTestListener\addIncompleteTest(), MediaWikiPHPUnitTestListener\addSkippedTest(), AutoLoader\autoload(), ExternalStoreDB\batchFetchBlobs(), RCCacheEntryFactory\buildCLink(), RCCacheEntryFactory\buildDiffLink(), ApiMain\checkBotReadOnly(), UploadFromChunks\concatenateChunks(), IPTC\convIPTCHelper(), Exif\debug(), ParserTestTopLevelSuite\debug(), Exif\debugFile(), SectionProfiler\debugGroup(), WebPHandler\decodeLosslessChunkHeader(), WebPHandler\decodeLossyChunkHeader(), JobQueueRedis\doAck(), JobQueueRedis\doBatchPush(), FileBackendMultiWrite\doOperationsInternal(), JobQueueRedis\doPop(), DjVuHandler\doTransform(), SvgHandler\doTransform(), TransformationalImageHandler\doTransform(), MediaWikiPHPUnitTestListener\endTest(), MediaWikiPHPUnitTestListener\endTestSuite(), LocalFileMoveBatch\execute(), CheckUsernames\execute(), WebPHandler\extractMetadata(), WebPHandler\extractMetadataFromChunks(), Message\extractParam(), PoolWorkArticleView\fallback(), ExternalStoreDB\fetchBlob(), Revision\fetchText(), DifferenceEngine\generateTextDiffBody(), ParserCache\get(), IPTC\getCharset(), LocalisationCache\getCompiledPluralRules(), ResourceLoaderWikiModule\getContent(), ContentHandler\getContentText(), ContentHandler\getForModelID(), ResourceLoaderImage\getImageData(), ParserCache\getKey(), RequestContext\getLanguage(), LocalFileMoveBatch\getMoveTriplets(), MessageCache\getMsgFromNamespace(), ResourceLoaderFileModule\getTemplates(), RequestContext\getTitle(), CdnCacheUpdate\HTCPPurge(), User\inDnsBlacklist(), ExternalStore\insertWithFallback(), EditPage\internalAttemptSave(), User\isCreatableName(), MessageCache\load(), MessageCache\loadFromDB(), SquidPurgeClient\log(), PoolCounterWork\logError(), MediaHandler\logErrorForExternalProcess(), JobQueueFederated\logException(), ApiBase\logFeatureUsage(), ApiMain\logRequest(), MediaWiki\main(), ApiMain\matchRequestedHeaders(), LocalFile\move(), MediaWiki\Site\MediaWikiPageNameNormalizer\normalizePageName(), IPTC\parse(), MessageCache\parse(), Parser\parse(), User\pingLimiter(), GitInfo\precomputeValues(), MediaWiki\preOutputCommit(), CdnCacheUpdate\purge(), ResourceLoaderFileModule\readStyleFile(), UploadFromUrl\reallyFetchFile(), MediaHandler\removeBadFile(), LocalFileMoveBatch\removeNonexistentFiles(), FileBackendMultiWrite\resyncFiles(), SquidPurgeClientPool\run(), ResourceLoaderModule\saveFileDependencies(), UploadFromUrl\saveTempFileChunk(), MWDebug\sendMessage(), WebResponse\setCookie(), MediaWikiPHPUnitTestListener\startTest(), MediaWikiPHPUnitTestListener\startTestSuite(), IPTC\timeHelper(), and wfShellExec().

◆ wfDebugMem()

wfDebugMem (   $exact = false)

Send a line giving PHP memory usage.

Parameters
bool$exactPrint exact byte values instead of kibibytes (default: false)

Definition at line 1056 of file GlobalFunctions.php.

References wfDebug().

Referenced by GlobalTest\testDebugFunctionTest().

◆ wfDeprecated()

wfDeprecated (   $function,
  $version = false,
  $component = false,
  $callerOffset = 2 
)

Throws a warning that $function is deprecated.

Parameters
string$function
string | bool$versionVersion of MediaWiki that the function was deprecated in (Added in 1.19).
string | bool$componentAdded in 1.19.
int$callerOffsetHow far up the call stack is the original caller. 2 = function that called the function that called wfDeprecated (Added in 1.20)
Returns
null
Examples
/src/tests/phpunit/MediaWikiTestCase.php.

Definition at line 1127 of file GlobalFunctions.php.

Referenced by MailAddress\__construct(), ApiResult\__construct(), ImageGallery\__construct(), Block\__construct(), StripState\__construct(), LoginForm\__construct(), OutputPage\__construct(), WikiImporter\__construct(), RevisiondeleteAction\__construct(), DeprecatedGlobal\_newObject(), OutputPage\addExtensionStyle(), ApiQueryLogEvents\addLogParams(), OutputPage\addParserOutputNoText(), WatchedItem\addWatch(), MediaWiki\Session\SessionManager\autoCreateUser(), Job\batchInsert(), WebRequest\checkSessionCookie(), User\clearCookie(), LoginForm\clearCreateaccountToken(), LoginForm\clearLoginThrottle(), LoginForm\clearLoginToken(), User\comparePasswords(), User\createNew(), User\crypt(), Article\doEdit(), WikiPage\doEdit(), WatchedItem\duplicateEntries(), User\edits(), Parser\extractTagsAndParams(), Article\fetchContent(), Title\fixUrlQueryArgs(), DummyLinker\formatSize(), Linker\formatSize(), DummyLinker\formatTemplates(), Linker\formatTemplates(), WatchedItem\fromUserTitle(), WikiPage\getAutosummary(), Article\getContent(), LoginForm\getCreateaccountToken(), User\getEditTokenTimestamp(), HTMLForm\getErrors(), OutputPage\getExtStyle(), LoginSignupSpecialPage\getFakeTemplate(), OutputPage\getHeadLinks(), DummyLinker\getInternalLinkAttributes(), Linker\getInternalLinkAttributes(), DummyLinker\getInternalLinkAttributesObj(), Linker\getInternalLinkAttributesObj(), DummyLinker\getInterwikiLinkAttributes(), Linker\getInterwikiLinkAttributes(), ApiPageSet\getInvalidTitles(), JsonContent\getJsonData(), MWLBFactory\getLBFactoryClass(), Linker\getLinkAttributesInternal(), DummyLinker\getLinkColour(), Linker\getLinkColour(), SpecialPageFactory\getList(), MWExceptionHandler\getLogId(), LoginForm\getLoginToken(), ApiBase\getModuleProfileName(), SearchEngine\getOpenSearchTemplate(), SpecialPageFactory\getPage(), User\getPasswordFactory(), ApiBase\getProfileDBTime(), ApiBase\getProfileTime(), Parser\getRandomString(), Revision\getRawComment(), Revision\getRawUser(), Revision\getRawUserText(), Database\getSearchEngine(), Article\getText(), WikiPage\getText(), Revision\getText(), WikiRevision\getText(), Title\getTitleInvalidRegex(), ArchivedFile\getUserText(), MediaWikiTestCase\hideDeprecated(), LoginForm\incLoginThrottle(), LoginForm\incrementLoginThrottle(), HTMLForm\isVForm(), VFormHTMLForm\isVForm(), WatchedItem\isWatched(), Linker\link(), ChangeTags\listExtensionActivatedTags(), ChangeTags\listExtensionDefinedTags(), Title\moveNoAuth(), Article\onArticleCreate(), Article\onArticleDelete(), Article\onArticleEdit(), SkinTemplate\outputPage(), WikiPage\prepareTextForEdit(), ApiBase\profileDBIn(), ApiBase\profileDBOut(), OutputPage\rateLimited(), ResourceLoaderFileModule\readStyleFiles(), WatchedItem\removeWatch(), MagicWord\replaceMultiple(), Parser\replaceUnusualEscapes(), Hooks\run(), ApiBase\safeProfileOut(), Article\selectFields(), User\setCookie(), LoginForm\setCreateaccountToken(), User\setExtendedLoginCookie(), DeferredUpdates\setImmediateMode(), LoginForm\setLoginToken(), Skin\showIPinHeader(), UploadBase\stashFileGetKey(), UploadBase\stashSession(), DifferenceEngine\textDiff(), Parser\uniqPrefix(), SiteStats\views(), wfErrorLog(), wfExtractThumbParams(), wfFixSessionID(), wfResetSessionID(), wfSetupSession(), OutputPage\wrapWikiMsg(), and MediaWiki\Session\PHPSessionHandler\write().

◆ wfDiff()

wfDiff (   $before,
  $after,
  $params = '-u' 
)

Returns unified plain-text diff of two texts.

"Useful" for machine processing of diffs.

Deprecated:
since 1.25, use DiffEngine/UnifiedDiffFormatter directly
Parameters
string$beforeThe text before the changes.
string$afterThe text after the changes.
string$paramsCommand-line options for the diff command.
Returns
string Unified diff of $before and $after

Definition at line 2679 of file GlobalFunctions.php.

References $params, $wgDiff, global, wfDebug(), wfEscapeShellArg(), and wfTempDir().

Referenced by ParserDiffTest\__call(), CompareParserCache\execute(), and CompareParsers\processRevision().

◆ wfErrorLog()

wfErrorLog (   $text,
  $file,
array  $context = [] 
)

Log to a file without getting "file size exceeded" signals.

Can also log to TCP or UDP with the syntax udp://host:port/prefix. This will send lines to the specified port, prefixed by the specified prefix and a space.

Since
1.25 support for additional context data
Parameters
string$text
string$fileFilename
array$contextAdditional logging context data
Exceptions
MWException
Deprecated:
since 1.25 Use \MediaWiki\Logger\LegacyLogger::emit or UDPTransport

Definition at line 1171 of file GlobalFunctions.php.

References $context, and wfDeprecated().

◆ wfEscapeShellArg()

wfEscapeShellArg ( )

Version of escapeshellarg() that works better on Windows.

Originally, this fixed the incorrect use of single quotes on Windows (https://bugs.php.net/bug.php?id=26285) and the locale problems on Linux in PHP 5.2.6+ (bug backported to earlier distro releases of PHP).

Parameters
string... strings to escape and glue together, or a single array of strings parameter
Returns
string

Definition at line 2209 of file GlobalFunctions.php.

References $args, $tokens, as, wfInitShellLocale(), and wfIsWindows().

Referenced by DumpPipeOutput\__construct(), MimeMagic\applyDefaultParameters(), CheckSyntax\checkFileWithCli(), DumpPipeOutput\closeAndRename(), UploadBase\detectVirus(), PopulateImageSha1\doDBUpdates(), DjVuHandler\doTransform(), HHVMMakeRepo\execute(), CheckSyntax\getGitModifiedFiles(), GitInfo\getHeadCommitDate(), TransformationalImageHandler\getMagickVersion(), Installer\locateExecutable(), ParserTestPrinter\quickDiff(), SvgHandler\rasterize(), ResourceLoaderImage\rasterize(), Maintenance\readlineEmulation(), CheckStorage\restoreText(), DjVuImage\retrieveMetaData(), BitmapHandler\rotate(), JpegHandler\rotate(), Dump7ZipOutput\setup7zCommand(), RecompressTracked\startReplicaProcs(), SevenZipStream\stream_open(), ExifBitmapHandler\swapICCProfile(), WfEscapeShellArgTest\testMultipleArgs(), WfEscapeShellArgTest\testMultipleArgsAsArray(), WfEscapeShellArgTest\testSingleInput(), DifferenceEngine\textDiff(), BitmapHandler\transformCustom(), wfDiff(), wfMerge(), wfShellExec(), wfShellWikiCmd(), RandomImageGenerator\writeImageWithApi(), and RandomImageGenerator\writeImageWithCommandLine().

◆ wfEscapeWikiText()

wfEscapeWikiText (   $text)

Escapes the given text so that it may be output using addWikiText() without any linking, formatting, etc.

making its way through. This is achieved by substituting certain characters with HTML entities. As required by the callers, "<nowiki>" is not used.

Parameters
string$textText to be escaped
Returns
string

Definition at line 1668 of file GlobalFunctions.php.

References $wgEnableMagicLinks, $wgUrlProtocols, as, and global.

Referenced by MediaHandler\addMeta(), CoreParserFunctions\basepagename(), CoreParserFunctions\basepagenamee(), Parser\braceSubstitution(), SpecialContributions\contributionsSub(), CoreParserFunctions\defaultsort(), Article\delete(), CoreParserFunctions\displaytitle(), Article\doDelete(), FileDeleteForm\doDelete(), WikiPage\doDeleteArticleReal(), FileDuplicateSearchPage\execute(), SpecialMergeHistory\execute(), SpecialUnblock\execute(), PasswordReset\execute(), CoreParserFunctions\fullpagename(), CoreParserFunctions\fullpagenamee(), CategoryViewer\getImageSection(), CategoryViewer\getPagesSection(), Parser\getUserSig(), Parser\getVariableValue(), EditPage\importFormData(), MediaWiki\Auth\LegacyHookPreAuthenticationProvider\makeFailResponse(), SpecialBlock\maybeAlterFormDefaults(), PPFrame_DOM\newChild(), PPFrame_Hash\newChild(), SpecialRandomInCategory\onSubmit(), SpecialBlock\onSuccess(), ImagePage\openShowImage(), ImageListPager\outputUserDoesNotExist(), CoreParserFunctions\pagename(), CoreParserFunctions\pagenamee(), SpecialBlock\postText(), FileDeleteForm\prepareMessage(), CoreParserFunctions\rootpagename(), CoreParserFunctions\rootpagenamee(), ProtectionForm\show(), SpecialSearch\showCreateLink(), UserrightsPage\showEditUserGroupsForm(), SpecialUndelete\showHistory(), EditPage\showIntro(), Article\showMissingArticle(), SpecialSearch\showResults(), LoginSignupSpecialPage\showSuccessPage(), EditPage\spamPageWithContent(), CoreParserFunctions\subjectpagename(), CoreParserFunctions\subjectpagenamee(), CoreParserFunctions\subpagename(), CoreParserFunctions\subpagenamee(), CoreParserFunctions\talkpagename(), CoreParserFunctions\talkpagenamee(), and SpecialBlock\validateTarget().

◆ wfExpandIRI()

wfExpandIRI (   $url)

Take a URL, make sure it's expanded to fully qualified, and replace any encoded non-ASCII Unicode characters with their UTF-8 original forms for more compact display and legibility for local audiences.

Todo:
handle punycode domains too
Parameters
string$url
Returns
string

Definition at line 887 of file GlobalFunctions.php.

References wfExpandUrl().

Referenced by Skin\printSource(), and GlobalTest\testExpandIRI().

◆ wfExpandIRI_callback()

wfExpandIRI_callback (   $matches)

Private callback for wfExpandIRI.

Parameters
array$matches
Returns
string

Definition at line 900 of file GlobalFunctions.php.

References $matches.

◆ wfExpandUrl()

wfExpandUrl (   $url,
  $defaultProto = PROTO_CURRENT 
)

Expand a potentially local URL to a fully-qualified URL.

Assumes $wgServer is correct.

The meaning of the PROTO_* constants is as follows: PROTO_HTTP: Output a URL starting with http:// PROTO_HTTPS: Output a URL starting with https:// PROTO_RELATIVE: Output a URL starting with // (protocol-relative URL) PROTO_CURRENT: Output a URL starting with either http:// or https:// , depending on which protocol was used for the current incoming request PROTO_CANONICAL: For URLs without a domain, like /w/index.php , use $wgCanonicalServer. For protocol-relative URLs, use the protocol of $wgCanonicalServer PROTO_INTERNAL: Like PROTO_CANONICAL, but uses $wgInternalServer instead of $wgCanonicalServer

Todo:
this won't work with current-path-relative URLs like "subdir/foo.html", etc.
Parameters
string$urlEither fully-qualified or a local path + query
string$defaultProtoOne of the PROTO_* constants. Determines the protocol to use if $url or $wgServer is protocol-relative
Returns
string Fully-qualified URL, current-path-relative URL or false if no valid URL can be constructed

Definition at line 551 of file GlobalFunctions.php.

References $wgCanonicalServer, $wgHttpsPort, $wgInternalServer, $wgRequest, $wgServer, global, PROTO_CANONICAL, PROTO_CURRENT, PROTO_HTTP, PROTO_HTTPS, PROTO_INTERNAL, wfAssembleUrl(), wfParseUrl(), and wfRemoveDotSegments().

Referenced by MWHttpRequest\__construct(), ApiQuerySiteinfo\appendGeneralInfo(), ApiQuerySiteinfo\appendInterwikiMap(), ApiQuerySiteinfo\appendRightsInfo(), EmailNotification\composeCommonMailtext(), SpecialApiHelp\execute(), ApiQueryExternalLinks\execute(), ApiQueryIWLinks\execute(), ApiQueryLangLinks\execute(), CdnCacheUpdate\expand(), ApiQueryInfo\extractPageInfo(), CoreParserFunctions\filepath(), ApiParse\formatIWLinks(), ApiParse\formatLangLinks(), Title\getCanonicalURL(), File\getCanonicalUrl(), SpecialVersion\getEntryPointInfo(), RevertAction\getFormFields(), WebRequest\getFullRequestURL(), Title\getFullURL(), File\getFullUrl(), OutputPage\getHeadLinksArray(), ApiQueryImageInfo\getInfo(), LocalRepo\getInfo(), Title\getInternalURL(), ApiRsd\getRsdApiList(), FeedItem\getUniqueId(), ForeignAPIRepo\httpGet(), MediaWiki\main(), RevertAction\onSuccess(), RSSFeed\outHeader(), RSSFeed\outItem(), OutputPage\output(), SpecialUploadStash\outputRemoteScaledThumb(), MediaWiki\performAction(), FileDeleteForm\prepareMessage(), CSSMin\remapOne(), ApiQueryExtLinksUsage\run(), ApiOpenSearch\search(), SearchSuggestion\setSuggestedTitle(), EditPage\showIntro(), ApiMain\substituteResultWithError(), SpecialSearchText\testSubPageRedirect(), WfExpandUrlTest\testWfExpandUrl(), File\transform(), MediaWiki\tryNormaliseRedirect(), wfExpandIRI(), and wfStreamThumb().

◆ wfFindFile()

◆ wfFixSessionID()

wfFixSessionID ( )
Deprecated:
since 1.27, PHP's session generation isn't used with MediaWiki\Session\SessionManager

Definition at line 2899 of file GlobalFunctions.php.

References wfDeprecated().

◆ wfForeignMemcKey()

wfForeignMemcKey (   $db,
  $prefix 
)

Make a cache key for a foreign DB.

Must match what wfMemcKey() would produce in context of the foreign wiki.

Parameters
string$db
string$prefix
string$args,...
Returns
string

Definition at line 2992 of file GlobalFunctions.php.

References $args.

Referenced by JobQueueDB\getCacheKey(), JobQueue\getRootJobCacheKey(), and GlobalTest\testWfForeignMemcKey().

◆ wfFormatStackFrame()

wfFormatStackFrame (   $frame)

Return a string representation of frame.

Parameters
array$frame
Returns
string

Definition at line 1605 of file GlobalFunctions.php.

Referenced by wfGetCaller().

◆ wfGetAllCallers()

wfGetAllCallers (   $limit = 3)

Return a string consisting of callers in the stack.

Useful sometimes for profiling specific points.

Parameters
int$limitThe maximum depth of the stack frame to return, or false for the entire stack.
Returns
string

Definition at line 1590 of file GlobalFunctions.php.

References $limit, and wfDebugBacktrace().

Referenced by MediaWiki\Session\SessionBackend\addData(), MediaWiki\Session\SessionBackend\dirty(), RequestContext\getTitle(), MessageCache\parse(), ApiBase\parseMsg(), OutputPage\parserOptions(), and MediaWiki\Session\SessionBackend\renew().

◆ wfGetCache()

wfGetCache (   $cacheType)

Get a specific cache object.

Parameters
int | string$cacheTypeA CACHE_* constants, or other key in $wgObjectCaches
Returns
BagOStuff

Definition at line 3412 of file GlobalFunctions.php.

Referenced by MessageCache\__construct(), JobQueue\__construct(), SpecialVersion\getCreditsForExtension(), CacheHelper\initCaching(), ForkController\initChild(), and CacheHelper\saveCache().

◆ wfGetCaller()

wfGetCaller (   $level = 2)

Get the name of the function which called this function wfGetCaller( 1 ) is the function with the wfGetCaller() call (ie.

FUNCTION) wfGetCaller( 2 ) [default] is the caller of the function running wfGetCaller() wfGetCaller( 3 ) is the parent of that.

Parameters
int$level
Returns
string
Examples
/src/tests/phpunit/MediaWikiTestCase.php.

Definition at line 1574 of file GlobalFunctions.php.

References wfDebugBacktrace(), and wfFormatStackFrame().

Referenced by StubObject\_unstub(), DeferredUpdates\addCallableUpdate(), MediaWikiTestCase\assertSelect(), WfGetCallerTest\callerOne(), ParserTestRunner\checkSetupDone(), ParserTestTopLevelSuite\debug(), WfGetCallerTest\intermediateFunction(), MWDebug\log(), WfGetCallerTest\testZero(), wfShellExec(), and wfShellExecWithStderr().

◆ wfGetDB()

wfGetDB (   $db,
  $groups = [],
  $wiki = false 
)

Get a Database object.

Parameters
int$dbIndex of the connection to get. May be DB_MASTER for the master (for write queries), DB_REPLICA for potentially lagged read queries, or an integer >= 0 for a particular server.
string | string[]$groupsQuery groups. An array of group names that this query belongs to. May contain a single string if the query is only in one group.
string | bool$wikiThe wiki ID, or false for the current wiki

Note: multiple calls to wfGetDB(DB_REPLICA) during the course of one request will always return the same object, unless the underlying connection or load balancer is manually destroyed.

Note 2: use $this->getDB() in maintenance scripts that may be invoked by updater to ensure that a proper database is being updated.

Todo:
Replace calls to wfGetDB with calls to LoadBalancer::getConnection() on an injected instance of LoadBalancer.
Returns
Database
Examples
/src/tests/phpunit/MediaWikiTestCase.php.

Definition at line 3074 of file GlobalFunctions.php.

References wfGetLB().

Referenced by SiteStatsInit\__construct(), LogPager\__construct(), Block\__construct(), SpecialRandomrootpage\__construct(), DeletedContribsPager\__construct(), ImageListPager\__construct(), ContribsPager\__construct(), IndexPager\__construct(), SearchDatabase\__construct(), MergeHistoryPager\__construct(), MergeHistory\__construct(), Pingback\acquireLock(), OutputPage\addCategoryLinks(), BotPasswordTest\addDBData(), MediaWiki\Session\BotPasswordSessionProviderTest\addDBDataOnce(), User\addGroup(), LinkCache\addLinkObj(), LogPage\addRelations(), User\addToDatabase(), MediaWikiTestCase\assertSelect(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProvider\beginPrimaryAuthentication(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\beginPrimaryAuthentication(), MediaWiki\Auth\EmailNotificationSecondaryAuthenticationProvider\beginSecondaryAccountCreation(), ImageListPager\buildQueryConds(), SiteStatsUpdate\cacheUpdate(), UserOptions\CHANGER(), CheckStorage\check(), User\checkAndSetTouched(), Pingback\checkIfSent(), TrackBlobs\checkIntegrity(), User\checkNewtalk(), RevisionDeleter\checkRevisionExistence(), RecompressTracked\checkTrackingTable(), User\clearAllNotifications(), User\clearSharedCache(), SpecialEditWatchlist\clearWatchlist(), CgzCopyTransaction\commit(), WikiPage\commitRollback(), Title\countRevisionsBetween(), SearchEngineFactory\create(), User\createNew(), Block\defaultRetroactiveAutoblock(), PrefixSearch\defaultSearchBackend(), ChangeTags\defineTag(), SearchMySQL\delete(), Block\delete(), Article\delete(), DifferenceEngine\deletedLink(), User\deleteNewtalk(), ChangeTags\deleteTagEverywhere(), Title\deleteTitleProtection(), SpecialUndelete\diffHeader(), SpecialRedirect\dispatchLog(), SiteStatsInit\doAllAndCommit(), RecompressTracked\doAllOrphans(), RecompressTracked\doAllPages(), UsersPager\doBatchLookups(), CategoryViewer\doCategoryQuery(), WikiPage\doCreate(), FileDeleteForm\doDelete(), WikiPage\doDeleteArticleReal(), SpecialExport\doExport(), SpecialRecentChangesLinked\doMainQuery(), WikiPage\doModify(), RecompressTracked\doOrphanList(), RecompressTracked\doPage(), GenderCache\doQuery(), LinkBatch\doQuery(), UserCache\doQuery(), MovePageForm\doSubmit(), WikiPage\doUpdateRestrictions(), LinkHolderArray\doVariants(), Title\estimateRevisionCount(), SpecialActiveUsers\execute(), ApiSetNotificationTimestamp\execute(), ParserTestsMaintenance\execute(), QueryPage\fetchFromCache(), Revision\fetchRevision(), HistoryAction\fetchRevisions(), Parser\fetchScaryTemplateMaybeFromCache(), Revision\fetchText(), TrackBlobs\findOrphanBlobs(), User\findUsersByGroup(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\finishAccountCreation(), RecompressTracked\finishIncompleteMoves(), DoubleRedirectJob\fixRedirects(), ApiEditPageTest\forceRevisionDate(), EditPageTest\forceRevisionDate(), Language\formatExpiry(), DoubleRedirectsPage\formatResult(), LCStoreDB\get(), MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesDB(), PageProps\getAllProperties(), Title\getAuthorsBetween(), ContentHandler\getAutoDeleteReason(), EditPage\getBaseRevision(), SpecialBlockList\getBlockListPager(), Block\getBlocksForIPList(), Title\getBrokenLinksFrom(), QueryPage\getCachedTimestamp(), Title\getCascadeProtectionSources(), WikiPage\getCategories(), WikiPage\getContributors(), RevDelRevisionList\getCurrent(), AllMessagesTablePager\getCustomisedStatuses(), Block\getDatabaseArray(), UserRightsProxy\getDB(), Maintenance\getDB(), SqlBagOStuff\getDB(), ApiBase\getDB(), BacklinkCache\getDB(), LinksDeletionUpdate\getDB(), LinksUpdate\getDB(), ResourceLoaderWikiModule\getDB(), ChangesListSpecialPage\getDB(), SpecialRecentChanges\getDB(), SpecialWatchlist\getDB(), LocalRepo\getDBFactory(), User\getEditCount(), ResourceLoaderModule\getFileDependencies(), DoubleRedirectJob\getFinalDestination(), User\getFirstEditTimestamp(), Title\getFirstRevision(), User\getFormerGroups(), WikiPage\getHiddenCategories(), EditPage\getLastDelete(), PageArchive\getLastRevisionText(), SpecialExport\getLinks(), Title\getLinksFrom(), Title\getLinksTo(), DifferenceEngine\getMarkPatrolledLinkInfo(), LocalRepo\getMasterDB(), Category\getMembers(), SpecialRandomInCategory\getMinAndMaxForCat(), MessageCache\getMsgFromNamespace(), ApiQuery\getNamedDB(), User\getNewMessageLinks(), Title\getNextRevisionID(), WikiPage\getOldestRevision(), Pingback\getOrCreatePingbackId(), SpecialExport\getPagesFromCategory(), SpecialExport\getPagesFromNamespace(), Title\getParentCategories(), PageArchive\getPreviousRevision(), Title\getPreviousRevisionID(), PageProps\getProperties(), SpecialRandomInCategory\getQueryInfo(), NewFilesPager\getQueryInfo(), UsersPager\getQueryInfo(), BrokenRedirectsPage\getQueryInfo(), LinkSearchPage\getQueryInfo(), MediaStatisticsPage\getQueryInfo(), WithoutInterwikiPage\getQueryInfo(), ImageListPager\getQueryInfoReal(), Block\getRangeCond(), QueryPage\getRecacheDB(), Revision\getRecentChange(), Title\getRedirectsHere(), WikiPage\getRedirectTarget(), PageArchive\getRevision(), OutputPage\getRlClient(), Linker\getRollbackEditCount(), LocalRepo\getSlaveDB(), Title\getSubpages(), HistoryBlobStub\getText(), HistoryBlobCurStub\getText(), TrackBlobs\getTextClause(), PageArchive\getTextFromRow(), Revision\getTimestampFromId(), Title\getTitleProtection(), Title\getTouched(), PasswordReset\getUsersByEmail(), User\idForName(), User\idFromName(), WikiRevision\importLogItem(), WikiRevision\importOldRevision(), CheckStorage\importRevision(), User\incEditCount(), User\incEditCountImmediate(), User\initEditCount(), Block\initFromRow(), Category\initialize(), BackupDumper\initProgress(), TrackBlobs\initTrackingTable(), Block\insert(), ManualLogEntry\insert(), WikiPage\insertProtectNullRevision(), WikiPage\insertRedirect(), WikiPage\insertRedirectEntry(), Title\invalidateCache(), HTMLCacheUpdateJob\invalidateTitles(), Title\isBigDeletion(), WikiPage\isCountable(), PageArchive\isDeleted(), Title\isDeleted(), Title\isDeletedQuick(), Title\isNewPage(), Title\isSingleRevRedirect(), Block\isWhitelistedFromAutoblocks(), ApiStashEdit\lastEditTime(), PageArchive\listAllPages(), ChangeTags\listExplicitlyDefinedTags(), PageArchive\listFiles(), PageArchive\listPagesByPrefix(), PageArchive\listRevisions(), ChangeTags\listSoftwareActivatedTags(), ChangeTags\listSoftwareDefinedTags(), MediaWiki\Interwiki\ClassicInterwikiLookup\load(), SiteStats\load(), ArchivedFile\load(), SiteStats\loadAndLazyInit(), User\loadFromCache(), User\loadFromDatabase(), MessageCache\loadFromDB(), User\loadGroups(), WikiPage\loadLastEdit(), User\loadOptions(), WikiPage\loadPageData(), Title\loadRestrictions(), Title\loadRestrictionsFromRows(), DifferenceEngine\loadRevisionData(), WikiPage\lockAndGetLatest(), ProfilerOutputDb\log(), ChangeTags\logTagManagementAction(), LocalIdLookup\lookupCentralIds(), LocalIdLookup\lookupUserNames(), LinkFilter\makeLikeArray(), RevisionStorageTest\makeRevision(), Pingback\markSent(), EditPage\mergeChangesIntoContent(), SearchMySQL\minSearchLength(), ChangeTags\modifyDisplayQuery(), MovePage\move(), RecompressTracked\moveTextRow(), moveToExternal(), MovePage\moveToInternal(), LinkSearchPage\mungeQuery(), Title\nameOf(), Revision\newFromConds(), RecentChange\newFromConds(), User\newFromConfirmationCode(), Block\newFromID(), Title\newFromID(), WikiPage\newFromID(), Title\newFromIDs(), UserArray\newFromIDs(), UserArray\newFromNames(), Revision\newFromPageId(), Revision\newFromTitle(), Block\newLoad(), User\newSystemUser(), RecentChange\notifyEdit(), RecentChange\notifyNew(), SiteStats\numberingroup(), SpecialPageLanguage\onSubmit(), InfoAction\pageCounts(), SiteStats\pagesInNs(), ApiStashEdit\parseAndStash(), ClassicInterwikiLookupTest\populateDB(), InterwikiTest\populateDB(), ResourceLoader\preloadModuleInfo(), WikiPage\prepareContentForEdit(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProvider\providerAllowsAuthenticationDataChange(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\providerAllowsAuthenticationDataChange(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProvider\providerChangeAuthenticationData(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\providerChangeAuthenticationData(), ManualLogEntry\publish(), Block\purgeExpired(), Title\purgeExpiredRestrictions(), RecentChangesUpdateJob\purgeExpiredRows(), SpecialPagesWithProp\queryExistingProps(), ImagePage\queryImageLinks(), DoubleRedirectsPage\reallyGetQueryInfo(), RecentChange\reallyMarkPatrolled(), RebuildRecentchanges\rebuildRecentChangesTablePass5(), QueryPage\recache(), MessageBlobStore\recacheMessageBlob(), SiteStatsInit\refresh(), Category\refreshCounts(), ChangeTagsList\reloadFromMaster(), RevDelList\reloadFromMaster(), User\removeGroup(), LinkHolderArray\replaceInternal(), WikiPage\replaceSectionContent(), ImportReporter\reportPage(), RevisionListBase\reset(), resolveStub(), resolveStubs(), CheckStorage\restoreText(), CategoryFinder\run(), DeleteLinksJob\run(), MediaWikiTestCase\run(), RecentChange\save(), LogPage\saveContent(), ResourceLoaderModule\saveFileDependencies(), User\saveOptions(), User\saveSettings(), UserNamePrefixSearch\search(), SpecialRandomInCategory\selectRandomPageFromDB(), RandomPage\selectRandomPageFromDB(), RevDelArchivedFileItem\setBits(), RevDelArchivedRevisionItem\setBits(), RevDelArchiveItem\setBits(), RevDelFileItem\setBits(), RevDelLogItem\setBits(), RevDelRevisionItem\setBits(), TestUser\setPasswordForUser(), TestPageProps\setProperties(), DatabaseTest\setUp(), LinksUpdateTest\setUp(), WikiPageTestContentHandlerUseDB\setUp(), RevisionTestContentHandlerUseDB\setUp(), ParserTestTopLevelSuite\setUp(), ParserTestRunner\setupDatabase(), RevisionDeleteUser\setUsernameBitfields(), RevDelList\setVisibility(), SpecialAllPages\showChunk(), MovePageForm\showForm(), SpecialWhatLinksHere\showIndirectLinks(), LogEventsList\showLogExtract(), Article\showPatrolFooter(), SpecialPrefixindex\showPrefixChunk(), SpecialVersion\softwareInformation(), LCStoreDB\startWrite(), Parser\statelessFetchRevision(), RevDelLogList\suggestTarget(), RecompressTracked\syncDBs(), ChangeTags\tagUsageStatistics(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest\testAccountCreation(), MediaWiki\Auth\AuthManagerTest\testAccountCreation(), MediaWiki\Auth\AuthManagerTest\testAccountCreationLogging(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest\testAuthentication(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProviderTest\testAuthentication(), MediaWiki\Auth\AuthManagerTest\testAutoAccountCreation(), ApiLoginTest\testBotPassword(), RevisionStorageTest\testConstructFromRow(), EditPageTest\testCreatePageTrx(), WikiPageTest\testDoDeleteArticle(), WikiPageTest\testDoDeleteUpdates(), WikiPageTest\testDoEdit(), WikiPageTest\testDoEditContent(), ReverseChronologicalPagerTest\testGetDateCond(), BotPasswordTest\testGetPassword(), ResourceLoaderWikiModuleTest\testGetPreloadedTitleInfo(), RevisionStorageTest\testNewFromArchiveRow(), MediaWiki\Session\UserInfoTest\testNewFromId(), RevisionStorageTest\testNewFromRow(), RevisionStorageTest\testNewNullRevision(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProviderTest\testProviderChangeAuthenticationData(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest\testProviderChangeAuthenticationData(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProviderTest\testProviderChangeAuthenticationDataEmail(), MultiWriteBagOStuffTest\testSetDelayed(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest\testSetPasswordResetFlag(), DatabaseTest\testStoredFunctions(), MultiWriteBagOStuffTest\testSyncMerge(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest\testTestUserCanAuthenticate(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProviderTest\testTestUserCanAuthenticate(), EditPageTest\testUpdatePageTrx(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProvider\testUserCanAuthenticate(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\testUserCanAuthenticate(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProvider\testUserExists(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\testUserExists(), RevisionStorageTest\testUserWasLastToEdit(), TrackBlobs\trackOrphanText(), TrackBlobs\trackRevisions(), SiteStatsUpdate\tryDBUpdateInternal(), ResourceLoader\tryRespondFromFileCache(), ChangeTags\undefineTag(), PageArchive\undeleteRevisions(), SearchMySQL\update(), SearchOracle\update(), SearchSqlite\update(), Block\update(), RecentChangesUpdateJob\updateActiveUsers(), WikiPage\updateCategoryCounts(), User\updateNewtalk(), ChangeTags\updateTags(), ChangeTags\updateTagSummaryRow(), ChangeTags\updateTagsWithChecks(), Block\updateTimestamp(), SearchMySQL\updateTitle(), SearchOracle\updateTitle(), SearchSqlite\updateTitle(), ActivityUpdateJob\updateWatchlistNotification(), UserOptions\USAGER(), Revision\userWasLastToEdit(), and ApiTag\validateLogId().

◆ wfGetLangObj()

wfGetLangObj (   $langcode = false)

Return a Language object from $langcode.

Parameters
Language | string | bool$langcodeEither:
  • a Language object
  • code of the language to get the message for, if it is a valid code create a language for that language, if it is a string but not a valid code then make a basic language object
  • a boolean: if it's false then use the global object for the current user's language (as a fallback for the old parameter functionality), or if it is true then use global object for the wiki's content language.
Returns
Language

Definition at line 1338 of file GlobalFunctions.php.

References $wgContLang, $wgLang, $wgLanguageCode, global, and wfDebug().

Referenced by Skin\doEditSectionLink(), SpecialAllMessages\execute(), MessageCache\get(), DateFormatter\getInstance(), Title\getPageLanguage(), CodeContentHandler\getPageLanguage(), ContentHandler\getPageLanguage(), Title\getPageViewLanguage(), CodeContentHandler\getPageViewLanguage(), DifferenceEngine\setTextLanguage(), ContentHandlerTest\testGetPageLanguage(), and Linker\tocList().

◆ wfGetLB()

◆ wfGetLBFactory()

◆ wfGetMainCache()

◆ wfGetMessageCacheStorage()

wfGetMessageCacheStorage ( )

Get the cache object used by the message cache.

Returns
BagOStuff

Definition at line 3431 of file GlobalFunctions.php.

References $wgMessageCacheType, and global.

Referenced by UploadFromUrlTestSuite\setUp(), and MessageCache\singleton().

◆ wfGetNull()

wfGetNull ( )

Get a platform-independent path to the null file, e.g.

/dev/null

Returns
string

Definition at line 3202 of file GlobalFunctions.php.

References wfIsWindows().

Referenced by MediaWiki\Tidy\RaggettExternal\cleanWrapped(), and Dump7ZipOutput\setup7zCommand().

◆ wfGetParserCacheStorage()

wfGetParserCacheStorage ( )

Get the cache object used by the parser cache.

Returns
BagOStuff

Definition at line 3441 of file GlobalFunctions.php.

References $wgParserCacheType, and global.

Referenced by PurgeParserCache\execute(), and UploadFromUrlTestSuite\setUp().

◆ wfGetPrecompiledData()

wfGetPrecompiledData (   $name)

Get an object from the precompiled serialized directory.

Parameters
string$name
Returns
mixed The variable on success, false on failure

Definition at line 2956 of file GlobalFunctions.php.

References $blob, $IP, global, and unserialize().

Referenced by IcuCollation\fetchFirstLetterData(), and Language\transformUsingPairFile().

◆ wfGetScriptUrl()

wfGetScriptUrl ( )

Get the script URL.

Returns
string Script URL

Definition at line 3168 of file GlobalFunctions.php.

◆ wfGlobalCacheKey()

wfGlobalCacheKey ( )

Make a cache key with database-agnostic prefix.

Doesn't have a wiki-specific namespace. Uses a generic 'global' prefix instead. Must have a prefix as otherwise keys that use a database name in the first segment will clash with wfMemcKey/wfForeignMemcKey.

Since
1.26
Parameters
string$args,...
Returns
string

Definition at line 3012 of file GlobalFunctions.php.

Referenced by MediaWiki\Auth\Throttler\clear(), MediaWiki\Auth\Throttler\increase(), and GlobalTest\testWfGlobalCacheKey().

◆ wfHostname()

◆ wfHttpError()

wfHttpError (   $code,
  $label,
  $desc 
)

Provide a simple HTTP error.

Parameters
int | string$code
string$label
string$desc

Definition at line 1776 of file GlobalFunctions.php.

References $code, $wgOut, global, HttpStatus\header(), and print.

Referenced by RawAction\getRawText(), MWExceptionRenderer\output(), AjaxDispatcher\performAction(), and MWException\report().

◆ wfIncrStats()

wfIncrStats (   $key,
  $count = 1 
)

Increment a statistics counter.

Parameters
string$key
int$count
Returns
void

Definition at line 1264 of file GlobalFunctions.php.

References $count, and RequestContext\getMain().

Referenced by ParserCache\get(), DifferenceEngine\getDiffBody(), ParserCache\getKey(), and WikiPage\getParserOutput().

◆ wfIniGetBool()

wfIniGetBool (   $setting)

Safety wrapper around ini_get() for boolean settings.

The values returned from ini_get() are pre-normalized for settings set via php.ini or php_flag/php_admin_flag... but not for those set via php_value/php_admin_value.

It's fairly common for people to use php_value instead of php_flag, which can leave you with an 'off' setting giving a false positive for code that just takes the ini_get() return value as a boolean.

To make things extra interesting, setting via php_value accepts "true" and "yes" as true, but php.ini and php_flag consider them false. :) Unrecognized values go false... again opposite PHP's own coercion from string to bool.

Luckily, 'properly' set settings will always come back as '0' or '1', so we only have to worry about them and the 'improper' settings.

I frickin' hate PHP... :P

Parameters
string$setting
Returns
bool

Definition at line 2190 of file GlobalFunctions.php.

Referenced by MWHttpRequest\canMakeRequests(), Installer\envCheckCache(), MWHttpRequest\factory(), MWHttpRequestTester\factory(), UploadBase\isEnabled(), WebInstaller\startSession(), and MediaWiki\Session\PHPSessionHandlerTest\testInstall().

◆ wfInitShellLocale()

wfInitShellLocale ( )

Workaround for http://bugs.php.net/bug.php?id=45132 escapeshellarg() destroys non-ASCII characters if LANG is not a UTF-8 locale.

Definition at line 2554 of file GlobalFunctions.php.

References $wgShellLocale, and global.

Referenced by wfEscapeShellArg(), and wfShellExec().

◆ wfIsBadImage()

wfIsBadImage (   $name,
  $contextTitle = false,
  $blacklist = null 
)

Determine if an image exists on the 'bad image list'.

The format of MediaWiki:Bad_image_list is as follows:

  • Only list items (lines starting with "*") are considered
  • The first link on a line must be a link to a bad image
  • Any subsequent links on the same line are considered to be exceptions, i.e. articles where the image may occur inline.
Parameters
string$nameThe image name to check
Title | bool$contextTitleThe page on which the image occurs, if known
string$blacklistWikitext of a file blacklist
Returns
bool

Definition at line 3510 of file GlobalFunctions.php.

References $cache, $line, $lines, $name, $title, as, wfFindFile(), wfMemcKey(), and wfMessage().

Referenced by GlobalWithDBTest\testWfIsBadImage(), and TraditionalImageGallery\toHTML().

◆ wfIsDebugRawPage()

wfIsDebugRawPage ( )

Returns true if debug logging should be suppressed if $wgDebugRawPage = false.

Returns
bool

Definition at line 1032 of file GlobalFunctions.php.

References $cache.

Referenced by wfDebug(), and wfLogProfilingData().

◆ wfIsHHVM()

wfIsHHVM ( )

◆ wfIsInfinity()

wfIsInfinity (   $str)

Determine input string is represents as infinity.

Parameters
string$strThe string to determine
Returns
bool
Since
1.25

Definition at line 3591 of file GlobalFunctions.php.

Referenced by ApiProtect\execute(), ProtectLogFormatter\formatExpiry(), ProtectionForm\getExpiry(), BlockLogFormatter\getParametersForApi(), SpecialBlock\parseExpiryInput(), SpecialBlock\processForm(), and Language\translateBlockExpiry().

◆ wfIsWindows()

◆ wfLoadExtension()

wfLoadExtension (   $ext,
  $path = null 
)

Load an extension.

This queues an extension to be loaded through the ExtensionRegistry system.

Parameters
string$extName of the extension to load
string | null$pathAbsolute path of where to find the extension.json file
Since
1.25

Definition at line 111 of file GlobalFunctions.php.

References $path, $wgExtensionDirectory, ExtensionRegistry\getInstance(), and global.

◆ wfLoadExtensions()

wfLoadExtensions ( array  $exts)

Load multiple extensions at once.

Same as wfLoadExtension, but more efficient if you are loading multiple extensions.

If you want to specify custom paths, you should interact with ExtensionRegistry directly.

See also
wfLoadExtension
Parameters
string[]$extsArray of extension names to load
Since
1.25

Definition at line 132 of file GlobalFunctions.php.

References $ext, $wgExtensionDirectory, as, ExtensionRegistry\getInstance(), and global.

◆ wfLoadSkin()

wfLoadSkin (   $skin,
  $path = null 
)

Load a skin.

See also
wfLoadExtension
Parameters
string$skinName of the extension to load
string | null$pathAbsolute path of where to find the skin.json file
Since
1.25

Definition at line 148 of file GlobalFunctions.php.

References $path, $wgStyleDirectory, ExtensionRegistry\getInstance(), and global.

◆ wfLoadSkins()

wfLoadSkins ( array  $skins)

Load multiple skins at once.

See also
wfLoadExtensions
Parameters
string[]$skinsArray of extension names to load
Since
1.25

Definition at line 163 of file GlobalFunctions.php.

References $skin, $wgStyleDirectory, as, ExtensionRegistry\getInstance(), and global.

◆ wfLocalFile()

◆ wfLogDBError()

wfLogDBError (   $text,
array  $context = [] 
)

Log for database errors.

Since
1.25 support for additional context data
Parameters
string$textDatabase error message.
array$contextAdditional logging context data

Definition at line 1109 of file GlobalFunctions.php.

References $context.

◆ wfLogProfilingData()

◆ wfLogWarning()

wfLogWarning (   $msg,
  $callerOffset = 1,
  $level = E_USER_WARNING 
)

Send a warning as a PHP error and the debug log.

This is intended for logging warnings in production. For logging development warnings, use WfWarn instead.

Parameters
string$msgMessage to send
int$callerOffsetNumber of items to go back in the backtrace to find the correct caller (1 = function calling wfLogWarning, ...)
int$levelPHP error level; defaults to E_USER_WARNING

Definition at line 1154 of file GlobalFunctions.php.

Referenced by Revision\compressRevisionText(), Revision\decompressRevisionText(), WikiPage\doDeleteArticleReal(), SpecialPageFactory\getPage(), SiteImporter\handleException(), OutputPage\parserOptions(), OutputPage\transformFilePath(), and wfMkdirParents().

◆ wfMakeUrlIndexes()

wfMakeUrlIndexes (   $url)

Make URL indexes, appropriate for the el_index field of externallinks.

Parameters
string$url
Returns
array

Definition at line 910 of file GlobalFunctions.php.

References wfParseUrl().

Referenced by LinksUpdate\getExternalInsertions(), LinkFilterTest\testMakeLikeArrayWithValidPatterns(), and GlobalTest\testMakeUrlIndexes().

◆ wfMatchesDomainList()

wfMatchesDomainList (   $url,
  $domains 
)

Check whether a given URL has a domain that occurs in a given set of domains.

Parameters
string$urlURL
array$domainsArray of domains (strings)
Returns
bool True if the host part of $url ends in one of the strings in $domains

Definition at line 964 of file GlobalFunctions.php.

References array(), as, and wfParseUrl().

Referenced by Skin\addToSidebarPlain(), Parser\getExternalLinkRel(), and GlobalTest\testWfMatchesDomainList().

◆ wfMemcKey()

wfMemcKey ( )

Make a cache key for the local wiki.

Parameters
string$args,...
Returns
string

Definition at line 2975 of file GlobalFunctions.php.

Referenced by LanguageConverter\__construct(), MediaWiki\Session\SessionBackend\__construct(), PoolWorkArticleView\__construct(), MediaWiki\Auth\AuthManager\autoCreateUser(), Preprocessor\cacheGetTree(), FileCacheBase\cacheMissKey(), Preprocessor\cacheSetTree(), MessageCache\clear(), MediaWiki\Session\TestBagOStuff\deleteSession(), WikiPage\doDeleteArticleReal(), ChangesFeed\execute(), FormatMetadata\fetchExtendedMetadata(), MediaWiki\Session\SessionManager\generateSessionId(), Skin\getCachedNotice(), CachingSiteStore\getCacheKey(), InfoAction\getCacheKey(), SpecialVersion\getCreditsForExtension(), DifferenceEngine\getDiffBodyCacheKey(), MediaWiki\Session\SessionManager\getEmptySessionInternal(), ApiHelp\getHelp(), MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry(), MessageCache\getLocalCache(), MessageCache\getMsgFromNamespace(), BacklinkCache\getNumLinks(), ParserCache\getOptionsKey(), ParserCache\getParserOutputKey(), MediaWiki\Session\TestBagOStuff\getSession(), MediaWiki\Session\SessionManager\getSessionById(), MediaWiki\Session\TestBagOStuff\getSessionFromBackend(), UploadBase\getSessionStatus(), User\getTouched(), SiteStatsUpdate\getTypeCacheKey(), MessageCache\getValidationHash(), FileCacheBase\incrMissesRecent(), Block\isWhitelistedFromAutoblocks(), ChangeTags\listExplicitlyDefinedTags(), ChangeTags\listSoftwareActivatedTags(), ChangeTags\listSoftwareDefinedTags(), MessageCache\load(), MessageCache\loadFromDBWithLock(), ExtensionRegistry\loadFromQueue(), MediaWiki\Session\SessionManager\loadSessionInfoFromStore(), SiteStats\numberingroup(), BacklinkCache\partition(), User\pingLimiter(), RebuildRecentchanges\purgeFeeds(), Article\purgePatrolFooterCache(), ChangeTags\purgeTagCacheAll(), ChangeTags\purgeTagUsageCache(), MessageCache\replace(), MediaWiki\Session\SessionBackend\resetId(), MediaWiki\Session\SessionBackend\save(), MessageCache\saveToCaches(), MessageCache\saveToLocalCache(), MediaWiki\Session\TestBagOStuff\setRawSession(), UploadBase\setSessionStatus(), BagOStuffTest\setUp(), MessageCache\setValidationHash(), Article\showMissingArticle(), Article\showPatrolFooter(), ChangeTags\tagUsageStatistics(), BagOStuffTest\testAdd(), MediaWiki\Auth\AuthManagerTest\testAutoAccountCreation(), BagOStuffTest\testChangeTTL(), BagOStuffTest\testGet(), BagOStuffTest\testGetMulti(), BagOStuffTest\testGetScopedLock(), BagOStuffTest\testGetWithSetCallback(), BagOStuffTest\testIncr(), BagOStuffTest\testIncrWithInit(), BagOStuffTest\testMerge(), MediaWiki\Session\SessionBackendTest\testUnpersist(), GlobalTest\testWfMemcKey(), User\touch(), SiteStatsUpdate\tryDBUpdateInternal(), MediaWiki\Session\SessionBackend\unpersist(), and wfIsBadImage().

◆ wfMemoryLimit()

wfMemoryLimit ( )

Set PHP's memory limit to the larger of php.ini or $wgMemoryLimit.

Returns
int Resulting value of the memory limit.

Definition at line 3304 of file GlobalFunctions.php.

References $wgMemoryLimit, global, wfDebug(), and wfShorthandToInteger().

◆ wfMerge()

wfMerge (   $old,
  $mine,
  $yours,
$result 
)

wfMerge attempts to merge differences between three texts.

Returns true for a clean merge and false for failure or a conflict.

Parameters
string$old
string$mine
string$yours
string$result
Returns
bool

Definition at line 2601 of file GlobalFunctions.php.

References $wgDiff3, global, wfDebug(), wfEscapeShellArg(), and wfTempDir().

Referenced by TextContentHandler\merge3(), and GlobalTest\testMerge().

◆ wfMergeErrorArrays()

wfMergeErrorArrays ( )

Merge arrays in the style of getUserPermissionsErrors, with duplicate removal e.g.

wfMergeErrorArrays( [ [ 'x' ] ], [ [ 'x', '2' ] ], [ [ 'x' ] ], [ [ 'y' ] ] ); returns: [ [ 'x', '2' ], [ 'x' ], [ 'y' ] ]

Parameters
array$array1,...
Returns
array

Definition at line 241 of file GlobalFunctions.php.

References $args, $out, $params, and as.

Referenced by MergeHistory\checkPermissions(), MovePage\checkPermissions(), SpecialImport\execute(), Title\isValidMoveOperation(), SpecialChangeContentModel\onSubmit(), and DifferenceEngine\showDiffPage().

◆ wfMessage()

wfMessage (   $key)

This is the function for getting translated interface messages.

See also
Message class for documentation how to use them.
https://www.mediawiki.org/wiki/Manual:Messages_API

This function replaces all old wfMsg* functions.

Parameters
string | string[] | MessageSpecifier$keyMessage key, or array of keys, or a MessageSpecifier
mixed$params,...Normal message parameters
Returns
Message
Since
1.17
See also
Message::__construct

Definition at line 1387 of file GlobalFunctions.php.

References $params.

◆ wfMessageFallback()

wfMessageFallback ( )

This function accepts multiple message keys and returns a message instance for the first message which is non-empty.

If all messages are empty then an instance of the first message key is returned.

Parameters
string | string[]$keys,...Message keys
Returns
Message
Since
1.18
See also
Message::newFallbackSequence

Definition at line 1408 of file GlobalFunctions.php.

References $args.

Referenced by SkinTemplate\buildContentNavigationUrls(), FileRepo\getDisplayName(), ImagePage\openShowImage(), and SkinTemplate\tabAction().

◆ wfMkdirParents()

wfMkdirParents (   $dir,
  $mode = null,
  $caller = null 
)

◆ wfMsgReplaceArgs()

wfMsgReplaceArgs (   $message,
  $args 
)

Replace message parameter keys on the given formatted output.

Parameters
string$message
array$args
Returns
string
Access:\n private

Definition at line 1421 of file GlobalFunctions.php.

References $args, and as.

Referenced by WikiPage\commitRollback(), MWException\msg(), MWExceptionRenderer\msg(), and ApiBase\parseMsg().

◆ wfNegotiateType()

wfNegotiateType (   $cprefs,
  $sprefs 
)

Returns the 'best' match between a client's requested internet media types and the server's list of available types.

Each list should be an associative array of type to preference (preference is a float between 0.0 and 1.0). Wildcards in the types are acceptable.

Parameters
array$cprefsClient's acceptable type list
array$sprefsServer's offered types
Returns
string
Todo:
FIXME: Doesn't handle params like 'text/plain; charset=UTF-8' XXX: generalize to negotiate other stuff

Definition at line 1942 of file GlobalFunctions.php.

References $type, as, and mimeTypeMatch().

Referenced by GlobalTest\testNegotiateType().

◆ wfObjectToArray()

wfObjectToArray (   $objOrArray,
  $recursive = true 
)

Recursively converts the parameter (an object) to an array with the same data.

Parameters
object | array$objOrArray
bool$recursive
Returns
array

Definition at line 291 of file GlobalFunctions.php.

References $value, as, and wfObjectToArray().

Referenced by wfObjectToArray().

◆ wfParseUrl()

wfParseUrl (   $url)

parse_url() work-alike, but non-broken.

Differences:

1) Does not raise warnings on bad URLs (just returns false). 2) Handles protocols that don't use :// (e.g., mailto: and news:, as well as protocol-relative URLs) correctly. 3) Adds a "delimiter" element to the array, either '://', ':' or '//' (see (2)).

Parameters
string$urlA URL to parse
Returns
string[]|bool Bits of the URL in an associative array, per PHP docs, false on failure
Examples
/src/includes/rcfeed/RedisPubSubFeedEngine.php.

Definition at line 817 of file GlobalFunctions.php.

References $wgUrlProtocols, and global.

Referenced by MWHttpRequest\__construct(), LinkSearchPage\execute(), ApiAMCreateAccount\execute(), ApiClientLogin\execute(), ApiLinkAccount\execute(), WikiReference\getDisplayName(), MediaWiki\getUrlDomainDistance(), WikiMap\getWikiWikiReferenceFromSites(), ThumbnailRenderJob\hitThumbUrl(), UploadFromUrl\isAllowedHost(), LinkFilter\makeLikeArray(), UserMailer\makeMsgId(), WfAssembleUrlTest\provideURLParts(), SquidPurgeClient\queuePurge(), RedisPubSubFeedEngine\send(), SpecialSearch\showInterwikiHit(), WfParseUrlTest\testWfParseUrl(), MediaWiki\triggerJobs(), wfExpandUrl(), wfMakeUrlIndexes(), and wfMatchesDomainList().

◆ wfPercent()

wfPercent (   $nr,
  $acc = 2,
  $round = true 
)
Parameters
int$nrThe number to format
int$accThe number of digits after the decimal point, default 2
bool$roundWhether or not to round the value, default true
Returns
string

Definition at line 2162 of file GlobalFunctions.php.

References $ret.

Referenced by profile_point\display(), ParserTestPrinter\reportPercentage(), and GlobalTest\testWfPercentTest().

◆ wfQueriesMustScale()

wfQueriesMustScale ( )

Should low-performance queries be disabled?

Returns
bool

Definition at line 3136 of file GlobalFunctions.php.

References $wgMiserMode, SiteStats\edits(), global, SiteStats\pages(), and SiteStats\users().

◆ wfRandom()

wfRandom ( )

Get a random decimal value between 0 and 1, in a way not likely to give duplicate values for any realistic number of articles.

Note
This is designed for use in relation to Special:RandomPage and the page_random database field.
Returns
string

Definition at line 317 of file GlobalFunctions.php.

Referenced by CompareParserCache\execute(), SpecialRandomInCategory\getRandomTitle(), RandomPage\getRandomTitle(), WikiPage\insertOn(), ApiQueryRandom\run(), and GlobalTest\testRandom().

◆ wfRandomString()

wfRandomString (   $length = 32)

Get a random string containing a number of pseudo-random hex characters.

Note
This is not secure, if you are trying to generate some sort of token please use MWCryptRand instead.
Parameters
int$lengthThe length of the string to generate
Returns
string
Since
1.20

Definition at line 335 of file GlobalFunctions.php.

Referenced by MockFileBackend\doGetLocalCopyMulti(), JobQueueDB\doPop(), SvgHandler\doTransform(), MakeTestEdits\execute(), TestUserRegistry\getImmutableTestUser(), MockLocalRepo\getLocalCopy(), MockLocalRepo\getLocalReference(), TestUserRegistry\getMutableTestUser(), Parser\getRandomString(), WebRequest\getRequestId(), MWExceptionHandler\handleFatalError(), StripState\merge(), UIDGenerator\newUUIDv4(), UploadSourceAdapter\registerSource(), FileBackendTest\setUp(), WANObjectCacheTest\testBusyValue(), WANObjectCacheTest\testCheckKeyInitHoldoff(), GlobalVarConfigTest\testConstructor(), WANObjectCacheTest\testDelete(), MediaWiki\Auth\LegacyHookPreAuthenticationProvider\testForAuthentication(), ReplicatedBagOStuffTest\testGet(), ReplicatedBagOStuffTest\testGetAbsent(), WANObjectCacheTest\testGetMulti(), WANObjectCacheTest\testGetMultiCheckKeys(), WANObjectCacheTest\testGetMultiWithSetCallback(), WANObjectCacheTest\testGetNotExists(), WANObjectCacheTest\testGetWithSetCallback(), WANObjectCacheTest\testGetWithSetCallback_versions(), WANObjectCacheTest\testGetWithSeveralCheckKeys(), GlobalVarConfigTest\testHas(), WANObjectCacheTest\testLockTSE(), WANObjectCacheTest\testLockTSESlow(), WANObjectCacheTest\testProcessCache(), GlobalTest\testRandomString(), JobQueueTest\testRootDeduplication(), FileBackendTest\testSanitizeOpHeaders(), ReplicatedBagOStuffTest\testSet(), WANObjectCacheTest\testSetAndGet(), MultiWriteBagOStuffTest\testSetDelayed(), MultiWriteBagOStuffTest\testSetImmediate(), WANObjectCacheTest\testSetOver(), WANObjectCacheTest\testSetWithLag(), WANObjectCacheTest\testStaleSet(), MultiWriteBagOStuffTest\testSyncMerge(), WANObjectCacheTest\testTouchKeys(), and WANObjectCacheTest\testWritePending().

◆ wfReadOnly()

◆ wfReadOnlyReason()

wfReadOnlyReason ( )

Check if the site is in read-only mode and return the message if so.

This checks wfConfiguredReadOnlyReason() and the main load balancer for replica DB lag. This may result in DB connection being made.

Returns
string|bool String when in read-only mode; false otherwise

Definition at line 1286 of file GlobalFunctions.php.

References wfConfiguredReadOnlyReason(), and wfGetLB().

Referenced by ReadOnlyError\__construct(), ProtectionForm\__construct(), ApiQuerySiteinfo\appendGeneralInfo(), MediaWiki\Auth\AuthManager\autoCreateUser(), MediaWiki\Auth\AuthManager\checkAccountCreatePermissions(), ApiBase\dieReadOnly(), WikiPage\doUpdateRestrictions(), EditPage\showHeader(), ReadOnlyErrorTest\testConstruction(), and wfReadOnly().

◆ wfRecursiveRemoveDir()

wfRecursiveRemoveDir (   $dir)

Remove a directory and all its content.

Does not hide error.

Parameters
string$dir
Examples
/src/tests/phpunit/MediaWikiTestCase.php.

Definition at line 2137 of file GlobalFunctions.php.

References $dir, as, wfDebug(), and wfRecursiveRemoveDir().

Referenced by TextPassDumperDatabaseTest\checkpointHelper(), MediaWikiTestCase\setUp(), MediaWikiTestCase\tearDown(), and wfRecursiveRemoveDir().

◆ wfRelativePath()

wfRelativePath (   $path,
  $from 
)

Generate a relative path name to the given file.

May explode on non-matching case-insensitive paths, funky symlinks, etc.

Parameters
string$pathAbsolute destination path including target filename
string$fromAbsolute source path, directory only
Returns
string

Definition at line 2836 of file GlobalFunctions.php.

References $from, $path, and wfBaseName().

Referenced by UploadDumper\outputItem().

◆ wfRemoveDotSegments()

wfRemoveDotSegments (   $urlPath)

Remove all dot-segments in the provided URL path.

For example, '/a/./b/../c/' becomes '/a/c/'. For details on the algorithm, please see RFC3986 section 5.2.4.

Todo:
Need to integrate this into wfExpandUrl (see T34168)
Parameters
string$urlPathURL path, potentially containing dot-segments
Returns
string URL path with all dot-segments removed

Definition at line 679 of file GlobalFunctions.php.

References $output.

Referenced by CSSMin\remapOne(), WfRemoveDotSegmentsTest\testWfRemoveDotSegments(), and wfExpandUrl().

◆ wfReportTime()

wfReportTime ( )

Returns a script tag that stores the amount of time it took MediaWiki to handle the request in milliseconds as 'wgBackendResponseTime'.

If $wgShowHostnames is true, the script will also set 'wgHostname' to the hostname of the server handling the request.

Returns
string

Definition at line 1488 of file GlobalFunctions.php.

References $wgRequestTime, $wgShowHostnames, global, Skin\makeVariablesScript(), and wfHostname().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ wfResetOutputBuffers()

wfResetOutputBuffers (   $resetGzipEncoding = true)

Clear away any user-level output buffers, discarding contents.

Suitable for 'starting afresh', for instance when streaming relatively large amounts of data without buffering, or wanting to output image files without ob_gzhandler's compression.

The optional $resetGzipEncoding parameter controls suppression of the Content-Encoding header sent by ob_gzhandler; by default it is left. See comments for wfClearOutputBuffers() for why it would be used.

Note that some PHP configuration options may add output buffer layers which cannot be removed; these are left in place.

Parameters
bool$resetGzipEncoding

Definition at line 1812 of file GlobalFunctions.php.

References $flags, $status, $wgDisableOutputCompression, and global.

Referenced by SpecialExport\execute(), SpecialUploadStash\outputContents(), ResourceLoader\tryRespondNotModified(), and wfClearOutputBuffers().

◆ wfResetSessionID()

wfResetSessionID ( )

Reset the session id.

Deprecated:
since 1.27, use MediaWiki\Session\SessionManager instead
Since
1.22

Definition at line 2909 of file GlobalFunctions.php.

References wfDeprecated(), and wfSetupSession().

◆ wfRestoreWarnings()

wfRestoreWarnings ( )
Deprecated:
since 1.26, use MediaWiki\restoreWarnings() directly Restore error level to previous value

Definition at line 1992 of file GlobalFunctions.php.

◆ wfRunHooks()

wfRunHooks (   $event,
array  $args = [],
  $deprecatedVersion = null 
)

Call hook functions defined in $wgHooks.

Parameters
string$eventEvent name
array$argsParameters passed to hook functions
string | null$deprecatedVersionOptionally mark hook as deprecated with version number
Returns
bool True if no handler aborted the hook
Deprecated:
since 1.25 - use Hooks::run

Definition at line 3456 of file GlobalFunctions.php.

References $args.

Referenced by HooksTest\testOldStyleHooks().

◆ wfScript()

wfScript (   $script = 'index')

Get the path to a specified script file, respecting file extensions; this is a wrapper around $wgScriptPath etc.

except for 'index' and 'load' which use $wgScript/$wgLoadScript

Parameters
string$scriptScript filename, sans extension
Returns
string

Definition at line 3152 of file GlobalFunctions.php.

References $wgLoadScript, $wgScript, $wgScriptPath, and global.

Referenced by SpecialPage\addFeedLinks(), SpecialRedirect\dispatchLog(), SpecialRedirect\dispatchPage(), SpecialRedirect\dispatchRevision(), SpecialRecentChanges\doHeader(), SpecialApiHelp\execute(), SpecialContributions\execute(), FileDuplicateSearchPage\execute(), LinkSearchPage\execute(), RedirectSpecialPage\execute(), SpecialRecentChanges\execute(), ApiHelp\fixHelpLinks(), HTMLForm\getAction(), SpecialLog\getActionButtons(), ResourceLoaderStartUpModule\getConfigSettings(), SpecialVersion\getEntryPointInfo(), OutputPage\getHeadLinksArray(), ApiHelp\getHelpInternal(), TablePager\getLimitForm(), ApiOpenSearch\getOpenSearchTemplate(), UsersPager\getPageHeader(), ApiRsd\getRsdApiList(), HistoryPager\getStartBody(), CategoryPager\getStartForm(), HistoryAction\onView(), SpecialWatchlist\setTopText(), ApiTestCase\setUp(), SpecialMergeHistory\showMergeForm(), SpecialProtectedtitles\showOptions(), SpecialProtectedpages\showOptions(), SpecialSearch\showResults(), SpecialUndelete\showSearchForm(), ApiMain\substituteResultWithError(), UserrightsPage\switchForm(), SpecialEmailUser\userForm(), and SpecialWhatLinksHere\whatlinkshereForm().

◆ wfSetBit()

wfSetBit ( $dest,
  $bit,
  $state = true 
)

As for wfSetVar except setting a bit.

Parameters
int$dest
int$bit
bool$state
Returns
bool

Definition at line 1741 of file GlobalFunctions.php.

◆ wfSetupSession()

wfSetupSession (   $sessionId = false)

Initialise php session.

Deprecated:
since 1.27, use MediaWiki\Session\SessionManager instead. Generally, "using" SessionManager will be calling ->getSessionById() or ::getGlobalSession() (depending on whether you were passing $sessionId here), then calling $session->persist().
Parameters
bool | string$sessionId

Definition at line 2934 of file GlobalFunctions.php.

References wfDeprecated().

Referenced by wfResetSessionID().

◆ wfSetVar()

wfSetVar ( $dest,
  $source,
  $force = false 
)

Sets dest to source and returns the original value of dest If source is NULL, it just returns the value, it doesn't set the variable If force is true, it will set the value even if source is NULL.

Parameters
mixed$dest
mixed$source
bool$force
Returns
mixed

Definition at line 1724 of file GlobalFunctions.php.

References $source.

Referenced by ParserOptions\disableContentConversion(), ParserOptions\disableTitleConversion(), OutputPage\enableClientCache(), ParserOptions\enableLimitReport(), LinkCache\forUpdate(), Block\fromMaster(), DatabaseMssql\ignoreErrors(), SpecialPage\including(), Block\isAutoblocking(), Block\isHardblock(), SpecialPage\listed(), Parser\Options(), Parser\OutputType(), OutputPage\parserOptions(), DatabaseMssql\prepareStatements(), ParserOutput\preventClickjacking(), Block\prevents(), DatabaseMssql\scrollableCursor(), ParserOptions\setAllowExternalImages(), ParserOptions\setAllowExternalImagesFrom(), ParserOptions\setAllowSpecialInclusion(), ParserOptions\setAllowUnsafeRawHtml(), CacheTime\setCacheTime(), ParserOutput\setCategoryLinks(), ParserOptions\setCleanSignatures(), ParserOptions\setCurrentRevisionCallback(), ParserOptions\setDateFormat(), ParserOptions\setEditSection(), ParserOutput\setEditSectionTokens(), ParserOptions\setEnableImageWhitelist(), ParserOptions\setExpensiveParserFunctionLimit(), ParserOptions\setExternalLinkTarget(), OutputPage\setFileVersion(), ParserOutput\setIndexPolicy(), ParserOptions\setInterfaceMessage(), ParserOptions\setInterwikiMagic(), ParserOptions\setIsPreview(), ParserOptions\setIsPrintable(), ParserOptions\setIsSectionPreview(), ParserOutput\setLanguageLinks(), SpecialPage\setListed(), ParserOptions\setMaxGeneratedPPNodeCount(), ParserOptions\setMaxIncludeSize(), ParserOptions\setMaxPPNodeCount(), ParserOptions\setMaxTemplateDepth(), WikiImporter\setNoticeCallback(), ParserOptions\setNumberHeadings(), ParserOptions\setPreSaveTransform(), ParserOptions\setRemoveComments(), OutputPage\setRevisionId(), OutputPage\setRevisionTimestamp(), ParserOutput\setSections(), ParserOptions\setSpeculativeRevIdCallback(), ParserOptions\setStubThreshold(), ParserOptions\setTargetLanguage(), ParserOptions\setTemplateCallback(), ParserOutput\setText(), ParserOptions\setThumbSize(), ParserOptions\setTidy(), ParserOutput\setTimestamp(), ParserOptions\setTimestamp(), ParserOutput\setTitleText(), ParserOutput\setTOCEnabled(), ParserOutput\setTOCHTML(), ParserOptions\setUserLang(), and Parser\Title().

◆ wfShellExec()

wfShellExec (   $cmd,
$retval = null,
  $environ = [],
  $limits = [],
  $options = [] 
)

Execute a shell command, with time and memory limits mirrored from the PHP configuration if supported.

Parameters
string | string[]$cmdIf string, a properly shell-escaped command line, or an array of unescaped arguments, in which case each value will be escaped Example: [ 'convert', '-font', 'font name' ] would produce "'convert' '-font' 'font name'"
null | mixed&$retvalOptional, will receive the program's exit code. (non-zero is usually failure). If there is an error from read, select, or proc_open(), this will be set to -1.
array$environOptional environment variables which should be added to the executed command environment.
array$limitsOptional array with limits(filesize, memory, time, walltime) this overwrites the global wgMaxShell* limits.
array$optionsArray of options:
  • duplicateStderr: Set this to true to duplicate stderr to stdout, including errors from limit.sh
  • profileMethod: By default this function will profile based on the calling method. Set this to a string for an alternative method to profile from
Returns
string Collected stdout as a string

Definition at line 2311 of file GlobalFunctions.php.

References $IP, $line, $lines, $options, $retval, $status, $time, $wgMaxShellFileSize, $wgMaxShellMemory, $wgMaxShellTime, $wgMaxShellWallClockTime, $wgShellCgroup, as, global, Profiler\instance(), SHELL_MAX_ARG_STRLEN, wfDebug(), wfDebugLog(), wfEscapeShellArg(), wfGetCaller(), wfInitShellLocale(), wfIsWindows(), and wfShellExecDisabled().

Referenced by UIDGenerator\__construct(), MimeMagic\applyDefaultParameters(), DjVuHandler\doTransform(), Installer\envCheckShellLocale(), SiteConfiguration\getConfig(), CheckSyntax\getGitModifiedFiles(), GitInfo\getHeadCommitDate(), TransformationalImageHandler\getMagickVersion(), Installer\locateExecutable(), ParserTestPrinter\quickDiff(), Maintenance\readlineEmulation(), DjVuImage\retrieveMetaData(), WfShellExecTest\testBug67870(), JpegPixelFormatTest\testPixelFormatRendering(), DifferenceEngine\textDiff(), wfShellExecWithStderr(), RandomImageGenerator\writeImageWithApi(), and RandomImageGenerator\writeImageWithCommandLine().

◆ wfShellExecDisabled()

wfShellExecDisabled ( )

Check if wfShellExec() is effectively disabled via php.ini config.

Returns
bool|string False or 'disabled'
Since
1.22

Definition at line 2276 of file GlobalFunctions.php.

References wfDebug().

Referenced by wfShellExec().

◆ wfShellExecWithStderr()

wfShellExecWithStderr (   $cmd,
$retval = null,
  $environ = [],
  $limits = [] 
)

Execute a shell command, returning both stdout and stderr.

Convenience function, as all the arguments to wfShellExec can become unwieldy.

Note
This also includes errors from limit.sh, e.g. if $wgMaxShellFileSize is exceeded.
Parameters
string | string[]$cmdIf string, a properly shell-escaped command line, or an array of unescaped arguments, in which case each value will be escaped Example: [ 'convert', '-font', 'font name' ] would produce "'convert' '-font' 'font name'"
null | mixed&$retvalOptional, will receive the program's exit code. (non-zero is usually failure)
array$environOptional environment variables which should be added to the executed command environment.
array$limitsOptional array with limits(filesize, memory, time, walltime) this overwrites the global wgMaxShell* limits.
Returns
string Collected stdout and stderr as a string

Definition at line 2545 of file GlobalFunctions.php.

References $retval, wfGetCaller(), and wfShellExec().

Referenced by UploadBase\detectVirus(), SvgHandler\rasterize(), BitmapHandler\rotate(), JpegHandler\rotate(), ExifBitmapHandler\swapICCProfile(), BitmapHandler\transformCustom(), and BitmapHandler\transformImageMagick().

◆ wfShellWikiCmd()

wfShellWikiCmd (   $script,
array  $parameters = [],
array  $options = [] 
)

Generate a shell-escaped command line string to run a MediaWiki cli script.

Note that $parameters should be a flat array and an option with an argument should consist of two consecutive items in the array (do not use "--option value").

Parameters
string$scriptMediaWiki cli script path
array$parametersArguments and options to the script
array$optionsAssociative array of options: 'php': The path to the php executable 'wrapper': Path to a PHP wrapper to handle the maintenance script
Returns
string

Definition at line 2577 of file GlobalFunctions.php.

References $options, $wgPhpCli, global, and wfEscapeShellArg().

Referenced by CleanupSpam\execute(), SiteConfiguration\getConfig(), MWDocGen\init(), and GlobalTest\testWfShellWikiCmd().

◆ wfShorthandToInteger()

wfShorthandToInteger (   $string = '',
  $default = -1 
)

Converts shorthand byte notation to integer form.

Parameters
string$string
int$defaultReturned if $string is empty
Returns
int

Definition at line 3353 of file GlobalFunctions.php.

References $last.

Referenced by Installer\envCheckMemory(), UploadBase\getMaxPhpUploadSize(), WebRequestUpload\isIniSizeOverflow(), WfShorthandToIntegerTest\testWfShorthandToInteger(), GlobalTest\testWfShorthandToInteger(), and wfMemoryLimit().

◆ wfShowingResults()

wfShowingResults (   $offset,
  $limit 
)
Todo:
document
Parameters
int$offset
int$limit
Returns
string

Definition at line 1623 of file GlobalFunctions.php.

References $limit, and wfMessage().

◆ wfSplitWikiID()

wfSplitWikiID (   $wiki)

Split a wiki ID into DB name and table prefix.

Parameters
string$wiki
Returns
array

Definition at line 3041 of file GlobalFunctions.php.

Referenced by ForeignDBViaLBRepo\__construct(), JobQueueDB\getCacheKey(), JobQueueRedis\getQueueKey(), and JobQueue\getRootJobCacheKey().

◆ wfStripIllegalFilenameChars()

wfStripIllegalFilenameChars (   $name)

Replace all invalid characters with '-'.

Additional characters can be defined in $wgIllegalFileChars (see T22489). By default, $wgIllegalFileChars includes ':', '/', '\'.

Parameters
string$nameFilename to process
Returns
string

Definition at line 3286 of file GlobalFunctions.php.

References $name, $wgIllegalFileChars, global, and wfBaseName().

Referenced by UploadBase\getTitle(), and MovePage\isValidFileMove().

◆ wfSuppressWarnings()

wfSuppressWarnings (   $end = false)

Reference-counted warning suppression.

Deprecated:
since 1.26, use MediaWiki\suppressWarnings() directly
Parameters
bool$end

Definition at line 1984 of file GlobalFunctions.php.

◆ wfTempDir()

wfTempDir ( )

Tries to get the system directory for temporary files.

First $wgTmpDirectory is checked, and then the TMPDIR, TMP, and TEMP environment variables are then checked in sequence, then sys_get_temp_dir(), then upload_tmp_dir from php.ini.

NOTE: When possible, use instead the tmpfile() function to create temporary files to avoid race conditions on file creation, etc.

Returns
string
Examples
/src/tests/phpunit/MediaWikiTestCase.php.

Definition at line 2075 of file GlobalFunctions.php.

References $wgTmpDirectory, TempFSFile\getUsableTempDirectory(), and global.

Referenced by UIDGenerator\__construct(), FSRepo\__construct(), UploadFromChunks\concatenateChunks(), FileBackendGroup\config(), ParserTestRunner\createRepoGroup(), MockFileBackend\doGetLocalCopyMulti(), FileBackendTest\doTestDoOperationsPipeline(), SvgHandler\doTransform(), WikiRevision\downloadSource(), WikiImporter\dumpTemp(), ApiImageRotate\execute(), HHVMMakeRepo\execute(), MWDocGen\execute(), TempFSFile\factory(), MockLocalRepo\getLocalCopy(), MockLocalRepo\getLocalReference(), MediaWikiTestCase\getNewTempFile(), UIDGenerator\getSequentialPerNodeIDs(), FileBackendGroup\guessMimeInternal(), JobRunner\loadBackoffs(), UploadFromUrl\makeTemporaryFile(), File\makeTransformTmpFile(), ClassicInterwikiLookupTest\populateCDB(), InterwikiTest\populateCDB(), FileBackendTest\provider_testStore(), ParserTestPrinter\quickDiff(), ResourceLoaderImage\rasterize(), CheckStorage\restoreText(), MigrateFileRepoLayoutTest\setUp(), WebPHandlerTest\setUp(), UploadStashTest\setUp(), JobRunner\syncBackoffDeltas(), DifferenceEngine\textDiff(), wfDiff(), and wfMerge().

◆ wfThumbIsStandard()

wfThumbIsStandard ( File  $file,
array  $params 
)

Returns true if these thumbnail parameters match one that MediaWiki requests from file description pages and/or parser output.

$params is considered non-standard if they involve a non-standard width or any non-default parameters aside from width and page number. The number of possible files with standard parameters is far less than that of all combinations; rate-limiting for them can thus be more generious.

Parameters
File$file
array$params
Returns
bool
Since
1.24 Moved from thumb.php to GlobalFunctions in 1.25

Definition at line 3610 of file GlobalFunctions.php.

References $handler, $params, $value, $wgImageLimits, $wgResponsiveImages, $wgThumbLimits, as, File\getHandler(), global, and use.

Referenced by WfThumbIsStandardTest\testIsStandard(), and wfStreamThumb().

◆ wfTimestamp()

wfTimestamp (   $outputtype = TS_UNIX,
  $ts = 0 
)

Get a timestamp string in one of various formats.

Parameters
mixed$outputtypeA timestamp in one of the supported formats, the function will autodetect which format is supplied and act accordingly.
mixed$tsOptional timestamp to convert, default 0 for the current time
Returns
string|bool String / false The same date in the format specified in $outputtype or false

Definition at line 2008 of file GlobalFunctions.php.

References $ret, ConvertibleTimestamp\convert(), and wfDebug().

Referenced by Block\__construct(), OutputPage\adaptCdnTTL(), BlockTest\addDBData(), LinkCache\addLinkObj(), ApiQuerySiteinfo\appendExtensions(), ApiQuerySiteinfo\appendGeneralInfo(), SpecialRecentChanges\buildMainQueryConds(), ApiStashEdit\buildStashValue(), FileCacheBase\cacheTimestamp(), SiteStatsUpdate\cacheUpdate(), ApiStashEdit\checkCache(), ApiMain\checkConditionalRequestHeaders(), AjaxResponse\checkLastModified(), OutputPage\checkLastModified(), WikiPage\commitRollback(), User\confirmationToken(), FileBackendMultiWrite\consistencyCheck(), LanguageWa\date(), Language\date(), DifferenceEngine\debug(), JobRunner\debugCallback(), LocalFile\decodeRow(), SqlBagOStuff\deleteObjectsExpiringBefore(), SpecialUndelete\diffHeader(), ApiTestCase\doApiRequestWithToken(), MemoryFileBackend\doCopyInternal(), MemoryFileBackend\doCreateInternal(), DBFileJournal\doLogChangeBatch(), WikiPage\doPurge(), MysqlUpdater\doSchemaRestructuring(), MemoryFileBackend\doStoreInternal(), FileBackendTest\doTestGetFileStat(), SpecialActiveUsers\execute(), SpecialExport\execute(), ApiEditPage\execute(), ApiFeedWatchlist\execute(), ApiMergeHistory\execute(), ApiProtect\execute(), ApiQueryAllUsers\execute(), ApiQueryBlocks\execute(), ApiQueryDeletedrevs\execute(), ApiQueryFilearchive\execute(), ApiQueryImageInfo\execute(), ApiQueryUsers\execute(), ApiSetNotificationTimestamp\execute(), ApiUndelete\execute(), LocalFileRestoreBatch\execute(), BenchmarkParse\execute(), UploadStashCleanup\execute(), FixTimestamps\execute(), GenerateSitemap\execute(), ImportTextFiles\execute(), PurgeParserCache\execute(), RemoveUnusedAccounts\execute(), UpdateSearchIndex\execute(), JobRunner\executeJob(), CacheTime\expired(), ApiQueryWatchlist\extractOutputData(), ApiQueryInfo\extractPageInfo(), ApiQueryRevisionsBase\extractRevisionInfo(), ApiQueryLogEvents\extractRowInfo(), ApiQueryRecentChanges\extractRowInfo(), ApiQueryContributions\extractRowInfo(), HistoryAction\feedEmpty(), MediaWiki\Logger\LegacyLogger\formatAsWfDebugLog(), FeedUtils\formatDiff(), Language\formatExpiry(), SpecialUndelete\formatFileRow(), LogFormatter\formatParameterValueForApi(), SpecialMergeHistory\formatRevisionRow(), SpecialUndelete\formatRevisionRow(), AtomFeed\formatTime(), RSSFeed\formatTime(), ImageListPager\formatValue(), GenerateSitemap\generateLimit(), RevDelArchivedFileItem\getApiData(), RevDelFileItem\getApiData(), RevDelRevisionItem\getApiData(), Block\getAutoblockExpiry(), ApiQueryUserInfo\getBlockInfo(), CacheTime\getCacheTime(), NewUsersLogFormatter\getComment(), ApiQueryUserInfo\getCurrentUserInfo(), LocalFile\getDescriptionTouched(), ProtectionForm\getExpiry(), FormatMetadata\getExtendedMetadataFromFile(), ApiQueryWatchlistIntegrationTest\getExternalRC(), User\getFirstEditTimestamp(), ApiQueryImageInfo\getInfo(), OutputPage\getJSVars(), MachineReadableRCFeedFormatter\getLine(), PNGMetadataExtractor\getMetadata(), SpecialRandomInCategory\getMinAndMaxForCat(), ApiParamInfo\getModuleInfo(), MediaWiki\Auth\AbstractPasswordPrimaryAuthenticationProvider\getNewPasswordExpiry(), BlockLogFormatter\getParametersForApi(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProvider\getPasswordResetData(), PageArchive\getPreviousRevision(), ActiveUsersPager\getQueryInfo(), RawAction\getRawText(), ImageHistoryList\getThumbForLine(), ArchivedFile\getTimestamp(), ForeignAPIFile\getTimestamp(), FSFile\getTimestamp(), DatabaseLogEntry\getTimestamp(), RCDatabaseLogEntry\getTimestamp(), ManualLogEntry\getTimestamp(), WikiPage\getTimestamp(), Revision\getTimestamp(), RevisionItemBase\getTimestamp(), MockFSFile\getTimestamp(), FileJournal\getTimestampedUUID(), Revision\getTimestampFromId(), User\getTouched(), ContribsPager\getUserCond(), Parser\getVariableValue(), ApiQueryInfo\getVisitingWatcherInfo(), ForeignAPIRepo\httpGet(), ImageHistoryList\imageHistoryLine(), Block\initFromRow(), Language\internalUserTimeAndDate(), User\isEmailConfirmationPending(), SqlBagOStuff\isExpired(), RecentChange\isInRCLifespan(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\isTimestampValid(), User\loadDefaults(), ChangesFeed\loadFromCache(), LocalFile\loadFromCache(), User\loadFromCache(), MessageCache\loadFromDB(), WikiPage\loadFromRow(), RecentChange\loadFromRow(), User\loadFromRow(), SpecialUndelete\loadRequest(), GenerateSitemap\main(), FormatMetadata\makeFormattedData(), MediaWiki\Session\Token\match(), SpecialBlock\maybeAlterFormDefaults(), User\newTouchedTimestamp(), OutputPage\output(), InfoAction\pageCounts(), ApiStashEdit\parseAndStash(), SpecialBlock\parseExpiryInput(), TableCleanup\progress(), ImageBuilder\progress(), ApiMainTest\provideCheckConditionalRequestHeaders(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider\providerAllowsAuthenticationDataChange(), LocalFile\publishTo(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), QueryPage\recache(), LocalFile\recordUpload2(), ApiQueryCategories\run(), ApiQueryCategoryMembers\run(), ApiQueryDuplicateFiles\run(), ApiQueryProtectedTitles\run(), ApiQueryQueryPage\run(), ApiQuerySearch\run(), ApiQueryWatchlistRaw\run(), CategoryMembershipChangeJob\run(), RefreshLinksJob\runForTitle(), ChangesFeed\saveToCache(), ApiMain\sendCacheHeaders(), ResourceLoader\sendResponseHeaders(), OutputPage\setLastModified(), WikiRevision\setTimestamp(), WikiPage\setTimestamp(), ApiMain\setupExecuteAction(), BackupDumper\showReport(), TextPassDumper\showReport(), UpdateLogging\sync(), EditPageTest\testAutoMerge(), MediaWiki\Auth\AbstractPasswordPrimaryAuthenticationProviderTest\testGetNewPasswordExpiry(), WfTimestampTest\testHttpDate(), WfTimestampTest\testNormalTimestamps(), WfTimestampTest\testOldTimestamps(), JobQueueTest\testRootDeduplication(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest\testSetPasswordResetFlag(), WfTimestampTest\testTimestampParameter(), TitlePermissionTest\testUserBlock(), Language\time(), Language\timeanddate(), IPTC\timeHelper(), DatabaseOracle\timestamp(), MediaWiki\Session\Token\toString(), ApiUpload\transformWarnings(), ResourceLoader\tryRespondFromFileCache(), RecentChangesUpdateJob\updateActiveUsers(), WikiPage\updateIfNewerOn(), Block\updateTimestamp(), ApiBase\validateTimestamp(), EditPage\wasDeletedSinceLastEdit(), wfStreamThumb(), wfTimestampOrNull(), and XmlDumpWriter\writeTimestamp().

◆ wfTimestampNow()

wfTimestampNow ( )

Convenience function; returns MediaWiki timestamp for the present time.

Returns
string

Definition at line 2037 of file GlobalFunctions.php.

References ConvertibleTimestamp\now(), and TS_MW.

Referenced by Revision\__construct(), CategoryMembershipChange\__construct(), LinksDeletionUpdate\__construct(), EditPageTest\assertEdit(), User\confirmEmail(), Preferences\datetimePreferences(), Block\doAutoblock(), WikiPage\doCreate(), SpecialWatchlist\doHeader(), WikiPage\doModify(), PoolWorkArticleView\doWork(), SpecialExport\execute(), ApiEditPage\execute(), ApiProtect\execute(), GenerateSitemap\execute(), ImportTextFiles\execute(), MigrateFileRepoLayout\execute(), PPFuzzTest\execute(), ResetUserEmail\execute(), UpdateSearchIndex\execute(), LogFormatterTestCase\expandDatabaseRow(), SqlBagOStuff\expireAll(), FormatMetadata\fetchExtendedMetadata(), Title\getCascadeProtectionSources(), Preferences\getDateOptions(), Parser\getRevisionTimestamp(), ManualLogEntry\getTimestamp(), ParserOptions\getTimestamp(), EditPage\importFormData(), ManualLogEntry\insert(), HTMLCacheUpdateJob\invalidateTitles(), MessageCache\isCacheExpired(), Block\isExpired(), Title\loadRestrictions(), Title\loadRestrictionsFromRows(), Job\newRootJobParams(), SpecialLockdb\onSubmit(), SpecialRecentChanges\optionsPanel(), RSSFeed\outHeader(), AtomFeed\outHeader(), WikiPage\prepareContentForEdit(), SpecialBlock\processForm(), WikiImporter\processRevision(), ParserCache\save(), ProtectionForm\save(), LogPage\saveContent(), HTMLFileCache\saveToFileCache(), AjaxResponse\storeInMemcached(), EditPageTest\testAutoMerge(), BlockTest\testBlockedUserCanNotCreateAccount(), EditPageTest\testCheckDirectEditingDisallowed_forNonTextContent(), BlockTest\testCrappyCrossWikiBlocks(), MessageTest\testExpiryParams(), and LanguageTest\testSprintfDateNoTtlIfNotNeeded().

◆ wfTimestampOrNull()

wfTimestampOrNull (   $outputtype = TS_UNIX,
  $ts = null 
)

◆ wfTransactionalTimeLimit()

wfTransactionalTimeLimit ( )

Set PHP's time limit to the larger of php.ini or $wgTransactionalTimeLimit.

Returns
int Prior time limit
Since
1.26

Definition at line 3332 of file GlobalFunctions.php.

References $wgTransactionalTimeLimit, and global.

Referenced by RollbackAction\onView(), Action\useTransactionalTimeLimit(), ApiBase\useTransactionalTimeLimit(), and SpecialPage\useTransactionalTimeLimit().

◆ wfUnpack()

wfUnpack (   $format,
  $data,
  $length = false 
)

Wrapper around php's unpack.

Parameters
string$formatThe format string (See php's docs)
string$dataA binary string of binary data
int | bool$lengthThe minimum length of $data or false. This is to prevent reading beyond the end of $data. false to disable the check.

Also be careful when using this function to read unsigned 32 bit integer because php might make it negative.

Exceptions
MWExceptionIf $data not long enough, or if unpack fails
Returns
array Associative array of the extracted data

Definition at line 3474 of file GlobalFunctions.php.

Referenced by JpegMetadataExtractor\doPSIR(), BmpHandler\getImageSize(), XCFHandler\getXCFMetaData(), JpegMetadataExtractor\jpegExtractMarker(), and JpegMetadataExtractor\segmentSplitter().

◆ wfUrlencode()

wfUrlencode (   $s)

We want some things to be included as literal characters in our title URLs for prettiness, which urlencode encodes by default.

According to RFC 1738, all of the following should be safe:

;:&=$-_.+!*'(),

RFC 1738 says ~ is unsafe, however RFC 3986 considers it an unreserved character which should not be encoded. More importantly, google chrome always converts %7E back to ~, and converting it in this function can cause a redirect loop (T105265).

But + is not safe because it's used to indicate a space; &= are only safe in paths and not in queries (and we don't distinguish here); ' seems kind of scary; and urlencode() doesn't touch -_. to begin with. Plus, although / is reserved, we don't care. So the list we unescape is:

;:$!*(),/~

However, IIS7 redirects fail when the url contains a colon (see T24709), so no fancy : for IIS7.

%2F in the page titles seems to fatally break for some reason.

Parameters
string$s
Returns
string

Definition at line 370 of file GlobalFunctions.php.

References $s.

Referenced by Title\__wakeup(), OutputPage\addHelpLink(), CoreParserFunctions\basepagenamee(), FileRepo\getDescriptionRenderUrl(), FileRepo\getDescriptionUrl(), LoginSignupSpecialPage\getFakeTemplate(), WikiReference\getLocalUrl(), Title\getLocalURL(), MediaWikiSite\getPageUrl(), Title\getPrefixedURL(), LoginSignupSpecialPage\getReturnToQueryStringFragment(), Title\getSubpageUrlForm(), Interwiki\getURL(), Parser\getVariableValue(), ApiBase\logFeatureUsage(), ApiMain\logRequest(), Title\makeTitle(), CoreParserFunctions\namespacee(), CoreParserFunctions\nse(), CoreParserFunctions\rootpagenamee(), Title\secureAndSplit(), CoreParserFunctions\speciale(), CoreParserFunctions\subjectspacee(), CoreParserFunctions\talkspacee(), GlobalTest\testUrlencode(), and WfUrlencodeTest\verifyEncodingFor().

◆ wfUrlProtocols()

wfUrlProtocols (   $includeProtocolRelative = true)

Returns a regular expression of url protocols.

Parameters
bool$includeProtocolRelativeIf false, remove '//' from the returned protocol list. DO NOT USE this directly, use wfUrlProtocolsWithoutProtRel() instead
Returns
string

Definition at line 757 of file GlobalFunctions.php.

References $retval, $wgUrlProtocols, as, and global.

Referenced by Parser\__construct(), Skin\addToSidebarPlain(), ResourceLoaderStartUpModule\getConfigSettings(), Skin\makeInternalOrExternalUrl(), Sanitizer\safeEncodeAttribute(), Sanitizer\validateAttributes(), and wfUrlProtocolsWithoutProtRel().

◆ wfUrlProtocolsWithoutProtRel()

wfUrlProtocolsWithoutProtRel ( )

Like wfUrlProtocols(), but excludes '//' from the protocol list.

Use this if you need a regex that matches all URL protocols but does not match protocol- relative URLs

Returns
string

Definition at line 802 of file GlobalFunctions.php.

References wfUrlProtocols().

Referenced by Parser\doMagicLinks(), and Language\markNoConversion().

◆ wfUseMW()

wfUseMW (   $req_ver)

This function works like "use VERSION" in Perl except it checks the version of MediaWiki, the program will die with a backtrace if the current version of MediaWiki is less than the version provided.

This is useful for extensions which due to their nature are not kept in sync with releases

Note: Due to the behavior of PHP's version_compare() which is used in this function, if you want to allow the 'wmf' development versions add a 'c' (or any single letter other than 'a', 'b' or 'p') as a post-fix to your targeted version number. For example if you wanted to allow any variation of 1.22 use ‘wfUseMW( '1.22c’ )‘. Using an 'a’ or 'b' instead of 'c' will not result in the same comparison due to the internal logic of version_compare().

See also
perldoc -f use
Deprecated:
since 1.26, use the "requires' property of extension.json
Parameters
string | int | float$req_verThe version to check, can be a string, an integer, or a float
Exceptions
MWException

Definition at line 2792 of file GlobalFunctions.php.

References $wgVersion, and global.

◆ wfUsePHP()

wfUsePHP (   $req_ver)

This function works like "use VERSION" in Perl, the program will die with a backtrace if the current version of PHP is less than the version provided.

This is useful for extensions which due to their nature are not kept in sync with releases, and might depend on other versions of PHP than the main code

Note: PHP might die due to parsing errors in some cases before it ever manages to call this function, such is life

See also
perldoc -f use
Parameters
string | int | float$req_verThe version to check, can be a string, an integer, or a float
Exceptions
MWException

Definition at line 2762 of file GlobalFunctions.php.

◆ wfVarDump()

wfVarDump (   $var)

A wrapper around the PHP function var_export().

Either print it or add it to the regular output ($wgOut).

Parameters
mixed$varA PHP variable to dump.

Definition at line 1759 of file GlobalFunctions.php.

References $s, $wgOut, global, and print.

◆ wfWaitForSlaves()

wfWaitForSlaves (   $ifWritesSince = null,
  $wiki = false,
  $cluster = false,
  $timeout = null 
)

Waits for the replica DBs to catch up to the master position.

Use this when updating very large numbers of rows, as in maintenance scripts, to avoid causing too much lag. Of course, this is a no-op if there are no replica DBs.

By default this waits on the main DB cluster of the current wiki. If $cluster is set to "*" it will wait on all DB clusters, including external ones. If the lag being waiting on is caused by the code that does this check, it makes since to use $ifWritesSince, particularly if cluster is "*", to avoid excess overhead.

Never call this function after a big DB write that is still in a transaction. This only makes sense after the possible lag inducing changes were committed.

Parameters
float | null$ifWritesSinceOnly wait if writes were done since this UNIX timestamp
string | bool$wikiWiki identifier accepted by wfGetLB
string | bool$clusterCluster name accepted by LBFactory. Default: false.
int | null$timeoutMax wait time. Default: 1 day (cli), ~10 seconds (web)
Returns
bool Success (able to connect and no timeouts reached)
Deprecated:
since 1.27 Use LBFactory::waitForReplication

Definition at line 3228 of file GlobalFunctions.php.

References $e, wfGetLBFactory(), and wfWikiID().

Referenced by NamespaceConflictChecker\checkLinkTable(), CompressOld\compressWithConcat(), RefreshLinks\deleteLinksFromNonexistent(), RefreshLinks\dfnCheckInterval(), FixExtLinksProtocolRelative\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), PopulateFilearchiveSha1\doDBUpdates(), PopulateImageSha1\doDBUpdates(), PopulateLogSearch\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), PopulateRevisionLength\doLenUpdates(), RefreshLinks\doRefreshLinks(), PopulateRevisionSha1\doSha1LegacyUpdates(), PopulateRevisionSha1\doSha1Updates(), UpdateSpecialPages\doSpecialPageCacheUpdates(), CleanupRemovedModules\execute(), UploadStashCleanup\execute(), ConvertUserOptions\execute(), DeleteBatch\execute(), DeleteDefaultMessages\execute(), DeleteEqualMessages\execute(), DeleteSelfExternals\execute(), FixUserRegistration\execute(), InitEditCount\execute(), MakeTestEdits\execute(), MigrateUserGroup\execute(), MoveBatch\execute(), PopulateCategory\execute(), RefreshImageMetadata\execute(), RemoveInvalidEmails\execute(), ResetUserTokens\execute(), BatchedQueryRunner\execute(), MwSql\execute(), TidyUpBug37714\execute(), UpdateMediaWiki\execute(), UpdateCollation\execute(), UpdateRestrictions\execute(), UpdateSpecialPages\execute(), FixDefaultJsonContentPages\handleRow(), moveToExternal(), resolveStubs(), BackupReader\showReport(), UpdateLogging\sync(), TrackBlobs\trackOrphanText(), TrackBlobs\trackRevisions(), PopulateContentModel\updatePageRows(), and FixBug20757\waitForSlaves().

◆ wfWarn()

wfWarn (   $msg,
  $callerOffset = 1,
  $level = E_USER_NOTICE 
)

Send a warning either to the debug log or in a PHP error depending on $wgDevelopmentWarnings.

To log warnings in production, use wfLogWarning() instead.

Parameters
string$msgMessage to send
int$callerOffsetNumber of items to go back in the backtrace to find the correct caller (1 = function calling wfWarn, ...)
int$levelPHP error level; defaults to E_USER_NOTICE; only used when $wgDevelopmentWarnings is true

Definition at line 1141 of file GlobalFunctions.php.

Referenced by Exif\__construct(), DatabaseTestHelper\__construct(), TextContent\__construct(), FakeDatabaseMysqlBase\__construct(), FakeDatabase\__construct(), Action\__construct(), MediaWiki\Tidy\RaggettExternal\cleanWrapped(), MediaWiki\Tidy\RaggettInternalPHP\cleanWrapped(), ForeignAPIRepo\fileExistsBatch(), Http\get(), SpecialPageFactory\getAliasList(), CacheHelper\getCachedValue(), WikiPage\getContentModel(), Action\getContext(), ParserCache\getKey(), SpecialPageFactory\getLocalNameFor(), Language\getMagic(), MediaWiki\initializeArticle(), Linker\link(), Linker\makeBrokenImageLinkObj(), BacklinkJobUtils\partitionBacklinkJob(), Autopromote\recCheckCondition(), EditPage\showEditForm(), and DifferenceEngine\textDiff().

◆ wfWikiID()

wfWikiID ( )

Get an ASCII string identifying this wiki This is used as a prefix in memcached keys.

Returns
string

Definition at line 3025 of file GlobalFunctions.php.

References $wgDBname, $wgDBprefix, and global.

Referenced by ApiMain\__construct(), FSRepo\__construct(), MediaWiki\Logger\Monolog\WikiProcessor\__invoke(), ApiQuerySiteinfo\appendGeneralInfo(), UserDupes\checkDupes(), JobRunner\commitMasterChanges(), FileBackendGroup\config(), ParserTestRunner\createRepoGroup(), WikiPage\doDeleteUpdates(), WikiPage\doEditUpdates(), MysqlUpdater\doTemplatelinksUpdate(), AttachLatest\execute(), CopyJobQueue\execute(), CreateAndPromote\execute(), DeleteRevision\execute(), GenerateSitemap\execute(), InitEditCount\execute(), SyncFileBackend\execute(), UpdateMediaWiki\execute(), UpdateSearchIndex\execute(), UserrightsPage\fetchUser(), MediaWiki\Logger\LegacyLogger\formatAsWfDebugLog(), MediaWiki\Logger\LegacyLogger\formatAsWfLogDBError(), MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached(), JobQueueGroup\getCachedConfigVar(), User\getCacheKey(), SiteConfiguration\getConfig(), ObjectCache\getDefaultKeyspace(), MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry(), MachineReadableRCFeedFormatter\getLine(), FileBackendDBRepoWrapperTest\getMocks(), User\getNewMessageLinks(), User\getNewMessageRevisionId(), Skin\getNewtalks(), Profiler\getProfileID(), Revision\getTitle(), Title\invalidateCache(), LocalIdLookup\isAttached(), ApiMain\logRequest(), RecompressTracked\logToFile(), UserMailer\makeMsgId(), EnqueueJob\newFromLocalJobs(), JobQueueMemoryTest\newJobQueue(), LBFactoryTest\newLBFactoryMulti(), TextPassDumper\openSpawn(), JobQueue\pop(), ClassicInterwikiLookupTest\populateHash(), InterwikiTest\populateHash(), TableCleanup\progress(), RecentChangesUpdateJob\purgeExpiredRows(), RefreshLinksJob\run(), JobRunner\run(), FileBackendTest\setUp(), LocalFileTest\setUp(), MigrateFileRepoLayoutTest\setUp(), StoreBatchTest\setUp(), JobQueueTest\setUp(), MediaWikiMediaTestCase\setUp(), UploadFromUrlTestSuite\setUp(), BackupDumper\showReport(), TextPassDumper\showReport(), LockManagerGroup\singleton(), JobQueueGroup\singleton(), RecompressTracked\startReplicaProcs(), ExternalStoreMwstore\store(), FileBackendTest\testAsyncWrites(), FileTest\testGenerateBucketsIfNeeded(), ResourceLoaderWikiModuleTest\testGetPreloadedTitleInfo(), FileTest\testGetThumbnailSource(), JobQueueTest\testGetWiki(), LocalIdLookupTest\testIsAttached(), FileBackendTest\testReadAffinity(), FileBackendTest\testSanitizeOpHeaders(), RecentChangesUpdateJob\updateActiveUsers(), and wfWaitForSlaves().