23 if ( !defined(
'MEDIAWIKI' ) ) {
24 die(
"This file is part of MediaWiki, it is not a valid entry point" );
34 use Wikimedia\AtEase\AtEase;
36 use Wikimedia\RequestTimeout\RequestTimeout;
37 use Wikimedia\WrappedString;
52 $path =
"$wgExtensionDirectory/$ext/extension.json";
73 foreach ( $exts as
$ext ) {
74 $registry->queue(
"$wgExtensionDirectory/$ext/extension.json" );
89 $path =
"$wgStyleDirectory/$skin/skin.json";
104 foreach ( $skins as $skin ) {
105 $registry->queue(
"$wgStyleDirectory/$skin/skin.json" );
120 $comparator =
static function ( $a, $b ):
int {
121 if ( is_string( $a ) && is_string( $b ) ) {
122 return strcmp( $a, $b );
124 if ( !is_array( $a ) && !is_array( $b ) ) {
125 throw new InvalidArgumentException(
126 'This function assumes that array elements are all strings or all arrays'
129 if ( count( $a ) !== count( $b ) ) {
130 return count( $a ) <=> count( $b );
134 while ( key( $a ) !==
null && key( $b ) !==
null ) {
135 $valueA = current( $a );
136 $valueB = current( $b );
137 $cmp = strcmp( $valueA, $valueB );
147 return array_udiff( $arr1, $arr2, $comparator );
171 foreach ( $args as $errors ) {
172 foreach ( $errors as $params ) {
173 $originalParams = $params;
176 $params = array_merge( [ $msg->getKey() ], $msg->getParams() );
178 # @todo FIXME: Sometimes get nested arrays for $params,
179 # which leads to E_NOTICEs
180 $spec = implode(
"\t", $params );
181 $out[$spec] = $originalParams;
184 return array_values( $out );
198 $keys = array_keys( $array );
199 $offsetByKey = array_flip(
$keys );
201 if ( !\array_key_exists( $after, $offsetByKey ) ) {
204 $offset = $offsetByKey[$after];
207 $before = array_slice( $array, 0, $offset + 1,
true );
208 $after = array_slice( $array, $offset + 1, count( $array ) - $offset,
true );
210 $output = $before + $insert + $after;
225 if ( is_object( $objOrArray ) ) {
226 $objOrArray = get_object_vars( $objOrArray );
228 foreach ( $objOrArray as $key => $value ) {
229 if ( $recursive && ( is_object( $value ) || is_array( $value ) ) ) {
233 $array[$key] = $value;
252 $max = mt_getrandmax() + 1;
253 $rand = number_format( ( mt_rand() * $max + mt_rand() ) / $max / $max, 12,
'.',
'' );
269 for ( $n = 0; $n < $length; $n += 7 ) {
270 $str .= sprintf(
'%07x', mt_rand() & 0xfffffff );
272 return substr( $str, 0, $length );
311 if ( $needle ===
null ) {
312 $needle = [
'%3B',
'%40',
'%24',
'%21',
'%2A',
'%28',
'%29',
'%2C',
'%2F',
'%7E' ];
313 if ( !isset( $_SERVER[
'SERVER_SOFTWARE'] ) ||
314 ( strpos( $_SERVER[
'SERVER_SOFTWARE'],
'Microsoft-IIS/7' ) ===
false )
320 $s = urlencode(
$s );
323 [
';',
'@',
'$',
'!',
'*',
'(',
')',
',',
'/',
'~',
':' ],
341 if ( $array2 !==
null ) {
346 foreach ( $array1 as $key => $value ) {
347 if ( $value !==
null && $value !==
false ) {
351 if ( $prefix !==
'' ) {
352 $key = $prefix .
"[$key]";
354 if ( is_array( $value ) ) {
356 foreach ( $value as $k => $v ) {
357 $cgi .= $firstTime ?
'' :
'&';
358 if ( is_array( $v ) ) {
361 $cgi .= urlencode( $key .
"[$k]" ) .
'=' . urlencode( $v );
366 if ( is_object( $value ) ) {
367 $value = $value->__toString();
369 $cgi .= urlencode( $key ) .
'=' . urlencode( $value );
386 if ( isset( $query[0] ) && $query[0] ==
'?' ) {
387 $query = substr( $query, 1 );
389 $bits = explode(
'&', $query );
391 foreach ( $bits as $bit ) {
395 if ( strpos( $bit,
'=' ) ===
false ) {
400 [ $key, $value ] = explode(
'=', $bit );
402 $key = urldecode( $key );
403 $value = urldecode( $value );
404 if ( strpos( $key,
'[' ) !==
false ) {
405 $keys = array_reverse( explode(
'[', $key ) );
406 $key = array_pop(
$keys );
408 foreach (
$keys as $k ) {
409 $k = substr( $k, 0, -1 );
410 $temp = [ $k => $temp ];
412 if ( isset( $ret[$key] ) && is_array( $ret[$key] ) ) {
413 $ret[$key] = array_merge( $ret[$key], $temp );
433 if ( is_array( $query ) ) {
436 if ( $query !=
'' ) {
439 $hashPos = strpos( $url,
'#' );
440 if ( $hashPos !==
false ) {
441 $fragment = substr( $url, $hashPos );
442 $url = substr( $url, 0, $hashPos );
446 if ( strpos( $url,
'?' ) ===
false ) {
454 if ( $fragment !==
false ) {
470 if ( MediaWikiServices::hasInstance() ) {
471 $services = MediaWikiServices::getInstance();
472 if ( $services->hasService(
'UrlUtils' ) ) {
473 return $services->getUrlUtils();
513 return wfGetUrlUtils()->expand( (
string)$url, $defaultProto ) ??
false;
557 return wfGetUrlUtils()->removeDotSegments( (
string)$urlPath );
569 $method = $includeProtocolRelative ?
'validProtocols' :
'validAbsoluteProtocols';
636 return wfGetUrlUtils()->matchesDomainList( (
string)$url, (array)$domains );
659 function wfDebug( $text, $dest =
'all', array $context = [] ) {
666 $text = trim( $text );
671 $context[
'private'] = ( $dest ===
false || $dest ===
'private' );
673 $logger = LoggerFactory::getInstance(
'wfDebug' );
674 $logger->debug( $text, $context );
683 if ( $cache !==
null ) {
688 if ( ( isset( $_GET[
'action'] ) && $_GET[
'action'] ==
'raw' )
724 $logGroup, $text, $dest =
'all', array $context = []
726 $text = trim( $text );
728 $logger = LoggerFactory::getInstance( $logGroup );
729 $context[
'private'] = ( $dest ===
false || $dest ===
'private' );
730 $logger->info( $text, $context );
742 $logger = LoggerFactory::getInstance(
'wfLogDBError' );
743 $logger->error( trim( $text ), $context );
762 function wfDeprecated( $function, $version =
false, $component =
false, $callerOffset = 2 ) {
763 if ( !is_string( $version ) && $version !==
false ) {
764 throw new InvalidArgumentException(
765 "MediaWiki version must either be a string or false. " .
766 "Example valid version: '1.33'"
793 function wfDeprecatedMsg( $msg, $version =
false, $component =
false, $callerOffset = 2 ) {
795 $callerOffset ===
false ?
false : $callerOffset + 1 );
808 function wfWarn( $msg, $callerOffset = 1, $level = E_USER_NOTICE ) {
821 function wfLogWarning( $msg, $callerOffset = 1, $level = E_USER_WARNING ) {
841 # Identify which language to get or create a language object for.
842 # Using is_object here due to Stub objects.
843 if ( is_object( $langcode ) ) {
844 # Great, we already have the object (hopefully)!
849 $services = MediaWikiServices::getInstance();
851 # $langcode is the language code of the wikis content language object.
852 # or it is a boolean and value is true
853 return $services->getContentLanguage();
857 if ( $langcode ===
false || $langcode ===
$wgLang->getCode() ) {
858 # $langcode is the language code of user language object.
859 # or it was a boolean and value is false
863 $languageNames = $services->getLanguageNameUtils()->getLanguageNames();
865 if ( isset( $languageNames[$langcode] ) ) {
866 # $langcode corresponds to a valid language.
867 return $services->getLanguageFactory()->getLanguage( $langcode );
870 # $langcode is a string, but not a valid language code; use content language.
871 wfDebug(
"Invalid language code passed to wfGetLangObj, falling back to content language." );
872 return $services->getContentLanguage();
897 if ( is_array( $key ) ) {
906 $message->params( ...$params );
937 # Fix windows line-endings
938 # Some messages are split with explode("\n", $msg)
939 $message = str_replace(
"\r",
'', $message );
942 if ( is_array( $args ) && $args ) {
943 if ( is_array( $args[0] ) ) {
944 $args = array_values( $args[0] );
946 $replacementKeys = [];
947 foreach ( $args as $n => $param ) {
948 $replacementKeys[
'$' . ( $n + 1 )] = $param;
950 $message = strtr( $message, $replacementKeys );
971 return php_uname(
'n' ) ?:
'unknown';
987 $elapsed = ( microtime(
true ) - $_SERVER[
'REQUEST_TIME_FLOAT'] );
989 $responseTime = round( $elapsed * 1000 );
990 $reportVars = [
'wgBackendResponseTime' => $responseTime ];
996 ResourceLoader::makeInlineScript(
997 ResourceLoader::makeConfigSetScript( $reportVars ),
1014 static $disabled =
null;
1016 if ( $disabled ===
null ) {
1017 $disabled = !function_exists(
'debug_backtrace' );
1019 wfDebug(
"debug_backtrace() is disabled" );
1027 return array_slice( debug_backtrace( DEBUG_BACKTRACE_PROVIDE_OBJECT, $limit + 1 ), 1 );
1029 return array_slice( debug_backtrace(), 1 );
1045 $frameFormat =
"%s line %s calls %s()\n";
1046 $traceFormat =
"%s";
1048 $frameFormat =
"<li>%s line %s calls %s()</li>\n";
1049 $traceFormat =
"<ul>\n%s</ul>\n";
1052 $frames = array_map(
static function ( $frame ) use ( $frameFormat ) {
1053 $file = !empty( $frame[
'file'] ) ? basename( $frame[
'file'] ) :
'-';
1054 $line = $frame[
'line'] ??
'-';
1055 $call = $frame[
'function'];
1056 if ( !empty( $frame[
'class'] ) ) {
1057 $call = $frame[
'class'] . $frame[
'type'] . $call;
1059 return sprintf( $frameFormat,
$file, $line, $call );
1062 return sprintf( $traceFormat, implode(
'', $frames ) );
1076 if ( isset( $backtrace[$level] ) ) {
1092 if ( !$limit || $limit > count( $trace ) - 1 ) {
1093 $limit = count( $trace ) - 1;
1095 $trace = array_slice( $trace, -$limit - 1, $limit );
1096 return implode(
'/', array_map(
'wfFormatStackFrame', $trace ) );
1106 if ( !isset( $frame[
'function'] ) ) {
1107 return 'NO_FUNCTION_GIVEN';
1109 return isset( $frame[
'class'] ) && isset( $frame[
'type'] ) ?
1110 $frame[
'class'] . $frame[
'type'] . $frame[
'function'] :
1126 return wfMessage(
'showingresults' )->numParams( $limit, $offset + 1 )->parse();
1139 static $result =
null;
1140 if ( $result ===
null || $force ) {
1142 if ( isset( $_SERVER[
'HTTP_ACCEPT_ENCODING'] ) ) {
1143 # @todo FIXME: We may want to disallow some broken browsers
1146 '/\bgzip(?:;(q)=([0-9]+(?:\.[0-9]+)))?\b/',
1147 $_SERVER[
'HTTP_ACCEPT_ENCODING'],
1151 if ( isset( $m[2] ) && ( $m[1] ==
'q' ) && ( $m[2] == 0 ) ) {
1154 wfDebug(
"wfClientAcceptsGzip: client accepts gzip." );
1174 static $repl =
null, $repl2 =
null;
1175 if ( $repl ===
null || defined(
'MW_PARSER_TEST' ) || defined(
'MW_PHPUNIT_TEST' ) ) {
1179 '"' =>
'"',
'&' =>
'&',
"'" =>
''',
'<' =>
'<',
1180 '=' =>
'=',
'>' =>
'>',
'[' =>
'[',
']' =>
']',
1181 '{' =>
'{',
'|' =>
'|',
'}' =>
'}',
';' =>
';',
1182 "\n#" =>
"\n#",
"\r#" =>
"\r#",
1183 "\n*" =>
"\n*",
"\r*" =>
"\r*",
1184 "\n:" =>
"\n:",
"\r:" =>
"\r:",
1185 "\n " =>
"\n ",
"\r " =>
"\r ",
1186 "\n\n" =>
"\n ",
"\r\n" =>
" \n",
1187 "\n\r" =>
"\n ",
"\r\r" =>
"\r ",
1188 "\n\t" =>
"\n	",
"\r\t" =>
"\r	",
1189 "\n----" =>
"\n----",
"\r----" =>
"\r----",
1190 '__' =>
'__',
'://' =>
'://',
1195 foreach ( $magicLinks as $magic ) {
1196 $repl[
"$magic "] =
"$magic ";
1197 $repl[
"$magic\t"] =
"$magic	";
1198 $repl[
"$magic\r"] =
"$magic ";
1199 $repl[
"$magic\n"] =
"$magic ";
1200 $repl[
"$magic\f"] =
"$magic";
1207 if ( substr( $prot, -1 ) ===
':' ) {
1208 $repl2[] = preg_quote( substr( $prot, 0, -1 ),
'/' );
1211 $repl2 = $repl2 ?
'/\b(' . implode(
'|', $repl2 ) .
'):/i' :
'/^(?!)/';
1213 $text = substr( strtr(
"\n$text", $repl ), 1 );
1215 $text = preg_replace( $repl2,
'$1:', $text );
1231 if (
$source !==
null || $force ) {
1247 $temp = (bool)( $dest & $bit );
1248 if ( $state !==
null ) {
1266 $s = str_replace(
"\n",
"<br />\n", var_export( $var,
true ) .
"\n" );
1267 if ( headers_sent() || !isset(
$wgOut ) || !is_object(
$wgOut ) ) {
1286 $wgOut->sendCacheControl();
1289 \MediaWiki\Request\HeaderCallback::warnIfHeadersSent();
1290 header(
'Content-type: text/html; charset=utf-8' );
1292 print
'<!DOCTYPE html>' .
1293 '<html><head><title>' .
1294 htmlspecialchars( $label ) .
1295 '</title></head><body><h1>' .
1296 htmlspecialchars( $label ) .
1298 nl2br( htmlspecialchars( $desc ) ) .
1299 "</p></body></html>\n";
1300 header(
'Content-Length: ' . ob_get_length() );
1322 while ( $status = ob_get_status() ) {
1323 if ( isset( $status[
'flags'] ) ) {
1324 $flags = PHP_OUTPUT_HANDLER_CLEANABLE | PHP_OUTPUT_HANDLER_REMOVABLE;
1325 $deleteable = ( $status[
'flags'] & $flags ) === $flags;
1326 } elseif ( isset( $status[
'del'] ) ) {
1327 $deleteable = $status[
'del'];
1330 $deleteable = $status[
'type'] !== 0;
1332 if ( !$deleteable ) {
1337 if ( $status[
'name'] ===
'MediaWikiIntegrationTestCase::wfResetOutputBuffersBarrier' ) {
1341 if ( !ob_end_clean() ) {
1346 if ( $resetGzipEncoding && $status[
'name'] ==
'ob_gzhandler' ) {
1349 header_remove(
'Content-Encoding' );
1385 $ret = MWTimestamp::convert( $outputtype, $ts );
1386 if ( $ret ===
false ) {
1387 wfDebug(
"wfTimestamp() fed bogus time value: TYPE=$outputtype; VALUE=$ts" );
1401 if ( $ts ===
null ) {
1414 return MWTimestamp::now( TS_MW );
1423 return PHP_OS_FAMILY ===
'Windows';
1433 return PHP_SAPI ===
'cli' || PHP_SAPI ===
'phpdbg';
1470 throw new MWException( __FUNCTION__ .
" given storage path '$dir'." );
1473 if ( $caller !==
null ) {
1474 wfDebug(
"$caller: called wfMkdirParents($dir)" );
1477 if ( strval( $dir ) ===
'' || is_dir( $dir ) ) {
1481 $dir = str_replace( [
'\\',
'/' ], DIRECTORY_SEPARATOR, $dir );
1483 if ( $mode ===
null ) {
1488 AtEase::suppressWarnings();
1489 $ok = mkdir( $dir, $mode,
true );
1490 AtEase::restoreWarnings();
1494 if ( is_dir( $dir ) ) {
1499 wfLogWarning( sprintf(
"failed to mkdir \"%s\" mode 0%o", $dir, $mode ) );
1511 if ( is_dir( $dir ) ) {
1512 $objects = scandir( $dir );
1513 foreach ( $objects as $object ) {
1514 if ( $object !=
"." && $object !=
".." ) {
1515 if ( filetype( $dir .
'/' . $object ) ==
"dir" ) {
1518 unlink( $dir .
'/' . $object );
1533 function wfPercent( $nr,
int $acc = 2,
bool $round =
true ) {
1534 $accForFormat = $acc >= 0 ? $acc : 0;
1535 $ret = sprintf(
"%.{$accForFormat}f", $nr );
1536 return $round ? round( (
float)$ret, $acc ) .
'%' :
"$ret%";
1579 $val = strtolower( $val );
1584 || preg_match(
"/^\s*[+-]?0*[1-9]/", $val );
1601 return Shell::escape( ...$args );
1629 $limits = [], $options = []
1631 if ( Shell::isDisabled() ) {
1634 return 'Unable to run external programs, proc_open() is disabled.';
1637 if ( is_array( $cmd ) ) {
1638 $cmd = Shell::escape( $cmd );
1641 $includeStderr = isset( $options[
'duplicateStderr'] ) && $options[
'duplicateStderr'];
1642 $profileMethod = $options[
'profileMethod'] ??
wfGetCaller();
1645 $result = Shell::command( [] )
1646 ->unsafeParams( (array)$cmd )
1647 ->environment( $environ )
1649 ->includeStderr( $includeStderr )
1650 ->profileMethod( $profileMethod )
1652 ->restrict( Shell::RESTRICT_NONE )
1659 $retval = $result->getExitCode();
1661 return $result->getStdout();
1682 return wfShellExec( $cmd, $retval, $environ, $limits,
1683 [
'duplicateStderr' =>
true,
'profileMethod' =>
wfGetCaller() ] );
1705 Hooks::runner()->onWfShellWikiCmd( $script, $parameters, $options );
1706 $cmd = [ $options[
'php'] ??
$wgPhpCli ];
1707 if ( isset( $options[
'wrapper'] ) ) {
1708 $cmd[] = $options[
'wrapper'];
1712 return Shell::escape( array_merge( $cmd, $parameters ) );
1726 function wfMerge( $old, $mine, $yours, &$result, &$mergeAttemptResult =
null ) {
1729 # This check may also protect against code injection in
1730 # case of broken installations.
1731 AtEase::suppressWarnings();
1733 AtEase::restoreWarnings();
1735 if ( !$haveDiff3 ) {
1740 # Make temporary files
1742 $oldtextFile = fopen( $oldtextName = tempnam( $td,
'merge-old-' ),
'w' );
1743 $mytextFile = fopen( $mytextName = tempnam( $td,
'merge-mine-' ),
'w' );
1744 $yourtextFile = fopen( $yourtextName = tempnam( $td,
'merge-your-' ),
'w' );
1746 # NOTE: diff3 issues a warning to stderr if any of the files does not end with
1747 # a newline character. To avoid this, we normalize the trailing whitespace before
1748 # creating the diff.
1750 fwrite( $oldtextFile, rtrim( $old ) .
"\n" );
1751 fclose( $oldtextFile );
1752 fwrite( $mytextFile, rtrim( $mine ) .
"\n" );
1753 fclose( $mytextFile );
1754 fwrite( $yourtextFile, rtrim( $yours ) .
"\n" );
1755 fclose( $yourtextFile );
1757 # Check for a conflict
1758 $cmd = Shell::escape(
$wgDiff3,
'-a',
'--overlap-only', $mytextName,
1759 $oldtextName, $yourtextName );
1760 $handle = popen( $cmd,
'r' );
1762 $mergeAttemptResult =
'';
1764 $data = fread( $handle, 8192 );
1765 if ( strlen( $data ) == 0 ) {
1768 $mergeAttemptResult .= $data;
1772 $conflict = $mergeAttemptResult !==
'';
1775 $cmd = Shell::escape(
$wgDiff3,
'-a',
'-e',
'--merge', $mytextName,
1776 $oldtextName, $yourtextName );
1777 $handle = popen( $cmd,
'r' );
1780 $data = fread( $handle, 8192 );
1781 if ( strlen( $data ) == 0 ) {
1787 unlink( $mytextName );
1788 unlink( $oldtextName );
1789 unlink( $yourtextName );
1791 if ( $result ===
'' && $old !==
'' && !$conflict ) {
1792 wfDebug(
"Unexpected null result from diff3. Command: $cmd" );
1811 if ( $suffix ==
'' ) {
1814 $encSuffix =
'(?:' . preg_quote( $suffix,
'#' ) .
')?';
1818 if ( preg_match(
"#([^/\\\\]*?){$encSuffix}[/\\\\]*$#",
$path,
$matches ) ) {
1836 $path = str_replace(
'/', DIRECTORY_SEPARATOR,
$path );
1837 $from = str_replace(
'/', DIRECTORY_SEPARATOR, $from );
1841 $from = rtrim( $from, DIRECTORY_SEPARATOR );
1843 $pieces = explode( DIRECTORY_SEPARATOR, dirname(
$path ) );
1844 $against = explode( DIRECTORY_SEPARATOR, $from );
1846 if ( $pieces[0] !== $against[0] ) {
1853 while ( count( $pieces ) && count( $against )
1854 && $pieces[0] == $against[0] ) {
1855 array_shift( $pieces );
1856 array_shift( $against );
1860 while ( count( $against ) ) {
1861 array_unshift( $pieces,
'..' );
1862 array_shift( $against );
1867 return implode( DIRECTORY_SEPARATOR, $pieces );
1901 function wfGetDB( $db, $groups = [], $wiki =
false ) {
1902 if ( $wiki ===
false ) {
1903 return MediaWikiServices::getInstance()
1904 ->getDBLoadBalancer()
1905 ->getMaintenanceConnectionRef( $db, $groups, $wiki );
1907 return MediaWikiServices::getInstance()
1908 ->getDBLoadBalancerFactory()
1909 ->getMainLB( $wiki )
1910 ->getMaintenanceConnectionRef( $db, $groups, $wiki );
1924 if ( $script ===
'index' ) {
1926 } elseif ( $script ===
'load' ) {
1929 return "{$wgScriptPath}/{$script}.php";
1941 return $value ?
'true' :
'false';
1964 $name = preg_replace(
1983 if ( $oldLimit != -1 ) {
1985 if ( $newLimit == -1 ) {
1986 wfDebug(
"Removing PHP's memory limit" );
1987 AtEase::suppressWarnings();
1989 ini_set(
'memory_limit', $newLimit );
1990 AtEase::restoreWarnings();
1991 } elseif ( $newLimit > $oldLimit ) {
1992 wfDebug(
"Raising PHP's memory limit to $newLimit bytes" );
1993 AtEase::suppressWarnings();
1995 ini_set(
'memory_limit', $newLimit );
1996 AtEase::restoreWarnings();
2010 $timeout = RequestTimeout::singleton();
2011 $timeLimit = $timeout->getWallTimeLimit();
2012 if ( $timeLimit !== INF ) {
2019 $timeLimit = (int)ini_get(
'max_execution_time' );
2025 ignore_user_abort(
true );
2038 $string = trim( $string ??
'' );
2039 if ( $string ===
'' ) {
2042 $last = $string[strlen( $string ) - 1];
2043 $val = intval( $string );
2076 if ( $length !==
false ) {
2077 $realLen = strlen( $data );
2078 if ( $realLen < $length ) {
2079 throw new MWException(
"Tried to use wfUnpack on a "
2080 .
"string of length $realLen, but needed one "
2081 .
"of at least length $length."
2086 AtEase::suppressWarnings();
2087 $result = unpack( $format, $data );
2088 AtEase::restoreWarnings();
2090 if ( $result ===
false ) {
2092 throw new MWException(
"unpack could not unpack binary data" );
2106 return in_array( $str, ExpiryDef::INFINITY_VALS );
2126 $multipliers = [ 1 ];
2130 $multipliers[] = 1.5;
2134 $handler =
$file->getHandler();
2135 if ( !$handler || !isset( $params[
'width'] ) ) {
2140 if ( isset( $params[
'page'] ) ) {
2141 $basicParams[
'page'] = $params[
'page'];
2147 foreach ( $multipliers as $multiplier ) {
2148 $thumbLimits = array_merge( $thumbLimits, array_map(
2149 static function ( $width ) use ( $multiplier ) {
2150 return round( $width * $multiplier );
2153 $imageLimits = array_merge( $imageLimits, array_map(
2154 static function ( $pair ) use ( $multiplier ) {
2156 round( $pair[0] * $multiplier ),
2157 round( $pair[1] * $multiplier ),
2164 if ( in_array( $params[
'width'], $thumbLimits ) ) {
2165 $normalParams = $basicParams + [
'width' => $params[
'width'] ];
2167 $handler->normaliseParams(
$file, $normalParams );
2171 foreach ( $imageLimits as $pair ) {
2172 $normalParams = $basicParams + [
'width' => $pair[0],
'height' => $pair[1] ];
2175 $handler->normaliseParams(
$file, $normalParams );
2177 if ( $normalParams[
'width'] == $params[
'width'] ) {
2188 foreach ( $params as $key => $value ) {
2189 if ( !isset( $normalParams[$key] ) || $normalParams[$key] != $value ) {
2211 foreach ( $baseArray as $name => &$groupVal ) {
2212 if ( isset( $newValues[$name] ) ) {
2213 $groupVal += $newValues[$name];
2217 $baseArray += $newValues;
global $wgCommandLineMode
wfGetLangObj( $langcode=false)
Return a Language object from $langcode.
wfThumbIsStandard(File $file, array $params)
Returns true if these thumbnail parameters match one that MediaWiki requests from file description pa...
wfVarDump( $var)
A wrapper around the PHP function var_export().
wfDebug( $text, $dest='all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
wfRandom()
Get a random decimal value in the domain of [0, 1), in a way not likely to give duplicate values for ...
wfUrlencode( $s)
We want some things to be included as literal characters in our title URLs for prettiness,...
wfParseUrl( $url)
parse_url() work-alike, but non-broken.
wfTempDir()
Tries to get the system directory for temporary files.
wfWarn( $msg, $callerOffset=1, $level=E_USER_NOTICE)
Send a warning either to the debug log or in a PHP error depending on $wgDevelopmentWarnings.
wfRandomString( $length=32)
Get a random string containing a number of pseudo-random hex characters.
wfTimestampOrNull( $outputtype=TS_UNIX, $ts=null)
Return a formatted timestamp, or null if input is null.
wfBaseName( $path, $suffix='')
Return the final portion of a pathname.
wfTimestampNow()
Convenience function; returns MediaWiki timestamp for the present time.
wfClientAcceptsGzip( $force=false)
Whether the client accept gzip encoding.
wfEscapeShellArg(... $args)
Locale-independent version of escapeshellarg()
wfLogDBError( $text, array $context=[])
Log for database errors.
wfLoadSkins(array $skins)
Load multiple skins at once.
wfUrlProtocolsWithoutProtRel()
Like wfUrlProtocols(), but excludes '//' from the protocol list.
wfRecursiveRemoveDir( $dir)
Remove a directory and all its content.
wfLoadExtension( $ext, $path=null)
Load an extension.
wfMemoryLimit( $newLimit)
Raise PHP's memory limit (if needed).
wfSetBit(&$dest, $bit, $state=true)
As for wfSetVar except setting a bit.
wfIniGetBool( $setting)
Safety wrapper around ini_get() for boolean settings.
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
wfShorthandToInteger(?string $string='', int $default=-1)
Converts shorthand byte notation to integer form.
wfBacktrace( $raw=null)
Get a debug backtrace as a string.
wfArrayDiff2( $arr1, $arr2)
Like array_diff( $arr1, $arr2 ) except that it works with two-dimensional arrays.
wfGetCaller( $level=2)
Get the name of the function which called this function wfGetCaller( 1 ) is the function with the wfG...
wfExpandIRI( $url)
Take a URL, make sure it's expanded to fully qualified, and replace any encoded non-ASCII Unicode cha...
wfMergeErrorArrays(... $args)
Merge arrays in the style of PermissionManager::getPermissionErrors, with duplicate removal e....
wfDeprecatedMsg( $msg, $version=false, $component=false, $callerOffset=2)
Log a deprecation warning with arbitrary message text.
wfShellExec( $cmd, &$retval=null, $environ=[], $limits=[], $options=[])
Execute a shell command, with time and memory limits mirrored from the PHP configuration if supported...
wfIsDebugRawPage()
Returns true if debug logging should be suppressed if $wgDebugRawPage = false.
wfHostname()
Get host name of the current machine, for use in error reporting.
wfExpandUrl( $url, $defaultProto=PROTO_CURRENT)
Expand a potentially local URL to a fully-qualified URL.
wfMerge( $old, $mine, $yours, &$result, &$mergeAttemptResult=null)
wfMerge attempts to merge differences between three texts.
wfShellWikiCmd( $script, array $parameters=[], array $options=[])
Generate a shell-escaped command line string to run a MediaWiki cli script.
wfPercent( $nr, int $acc=2, bool $round=true)
wfReportTime( $nonce=null)
Returns a script tag that stores the amount of time it took MediaWiki to handle the request in millis...
wfSetVar(&$dest, $source, $force=false)
Sets dest to source and returns the original value of dest If source is NULL, it just returns the val...
wfShellExecWithStderr( $cmd, &$retval=null, $environ=[], $limits=[])
Execute a shell command, returning both stdout and stderr.
wfGetNull()
Get a platform-independent path to the null file, e.g.
wfRelativePath( $path, $from)
Generate a relative path name to the given file.
wfHttpError( $code, $label, $desc)
Provide a simple HTTP error.
wfUrlProtocols( $includeProtocolRelative=true)
Returns a regular expression of url protocols.
wfUnpack( $format, $data, $length=false)
Wrapper around php's unpack.
wfMessageFallback(... $keys)
This function accepts multiple message keys and returns a message instance for the first message whic...
wfShowingResults( $offset, $limit)
wfGetAllCallers( $limit=3)
Return a string consisting of callers in the stack.
wfRemoveDotSegments( $urlPath)
Remove all dot-segments in the provided URL path.
wfArrayPlus2d(array $baseArray, array $newValues)
Merges two (possibly) 2 dimensional arrays into the target array ($baseArray).
wfLogWarning( $msg, $callerOffset=1, $level=E_USER_WARNING)
Send a warning as a PHP error and the debug log.
wfTransactionalTimeLimit()
Raise the request time limit to $wgTransactionalTimeLimit.
wfDebugLog( $logGroup, $text, $dest='all', array $context=[])
Send a line to a supplementary debug log file, if configured, or main debug log if not.
wfObjectToArray( $objOrArray, $recursive=true)
Recursively converts the parameter (an object) to an array with the same data.
wfClearOutputBuffers()
More legible than passing a 'false' parameter to wfResetOutputBuffers():
wfLoadSkin( $skin, $path=null)
Load a skin.
wfMsgReplaceArgs( $message, $args)
Replace message parameter keys on the given formatted output.
wfGetServerUrl( $proto)
Get the wiki's "server", i.e.
wfStringToBool( $val)
Convert string value to boolean, when the following are interpreted as true:
wfDebugBacktrace( $limit=0)
Safety wrapper for debug_backtrace().
wfAppendQuery( $url, $query)
Append a query string to an existing URL, which may or may not already have query string parameters a...
wfStripIllegalFilenameChars( $name)
Replace all invalid characters with '-'.
wfFormatStackFrame( $frame)
Return a string representation of frame.
wfArrayToCgi( $array1, $array2=null, $prefix='')
This function takes one or two arrays as input, and returns a CGI-style string, e....
wfScript( $script='index')
Get the path to a specified script file, respecting file extensions; this is a wrapper around $wgScri...
wfCgiToArray( $query)
This is the logical opposite of wfArrayToCgi(): it accepts a query string as its argument and returns...
wfIsWindows()
Check if the operating system is Windows.
wfMatchesDomainList( $url, $domains)
Check whether a given URL has a domain that occurs in a given set of domains.
wfIsInfinity( $str)
Determine input string is represents as infinity.
wfMkdirParents( $dir, $mode=null, $caller=null)
Make directory, and make all parent directories if they don't exist.
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
wfLoadExtensions(array $exts)
Load multiple extensions at once.
wfBoolToStr( $value)
Convenience function converts boolean values into "true" or "false" (string) values.
wfMessage( $key,... $params)
This is the function for getting translated interface messages.
wfEscapeWikiText( $text)
Escapes the given text so that it may be output using addWikiText() without any linking,...
wfDeprecated( $function, $version=false, $component=false, $callerOffset=2)
Logs a warning that a deprecated feature was used.
wfArrayInsertAfter(array $array, array $insert, $after)
Insert an array into another array after the specified key.
wfAssembleUrl( $urlParts)
This function will reassemble a URL parsed with wfParseURL.
wfResetOutputBuffers( $resetGzipEncoding=true)
Clear away any user-level output buffers, discarding contents.
wfIsCLI()
Check if we are running from the commandline.
if(!defined( 'MW_NO_SESSION') &&! $wgCommandLineMode) $wgOut
if(!defined( 'MW_NO_SESSION') &&! $wgCommandLineMode) $wgLang
static isStoragePath( $path)
Check if a given path is a "mwstore://" path.
Implements some public methods and some protected utility functions which are required by multiple ch...
static runner()
Get a HookRunner instance for calling hooks using the new interfaces.
static header( $code)
Output an HTTP status code header.
static warning( $msg, $callerOffset=1, $level=E_USER_NOTICE, $log='auto')
Adds a warning entry to the log.
static deprecated( $function, $version=false, $component=false, $callerOffset=2)
Show a warning that $function is deprecated.
static deprecatedMsg( $msg, $version=false, $component=false, $callerOffset=2)
Log a deprecation warning with arbitrary message text.
static newFallbackSequence(... $keys)
Factory function accepting multiple message keys and returning a message instance for the first messa...
static newFromSpecifier( $value)
Transform a MessageSpecifier or a primitive value used interchangeably with specifiers (a message key...
static getUsableTempDirectory()
static legalChars()
Get a regex character class describing the legal characters in a link.
static detectProtocol()
Detect the protocol from $_SERVER.
$wgLanguageCode
Config variable stub for the LanguageCode setting, for use by phpdoc and IDEs.
$wgScript
Config variable stub for the Script setting, for use by phpdoc and IDEs.
$wgInternalServer
Config variable stub for the InternalServer setting, for use by phpdoc and IDEs.
$wgThumbLimits
Config variable stub for the ThumbLimits setting, for use by phpdoc and IDEs.
$wgDebugLogPrefix
Config variable stub for the DebugLogPrefix setting, for use by phpdoc and IDEs.
$wgPhpCli
Config variable stub for the PhpCli setting, for use by phpdoc and IDEs.
$wgOverrideHostname
Config variable stub for the OverrideHostname setting, for use by phpdoc and IDEs.
$wgImageLimits
Config variable stub for the ImageLimits setting, for use by phpdoc and IDEs.
$wgShowHostnames
Config variable stub for the ShowHostnames setting, for use by phpdoc and IDEs.
$wgTmpDirectory
Config variable stub for the TmpDirectory setting, for use by phpdoc and IDEs.
$wgStyleDirectory
Config variable stub for the StyleDirectory setting, for use by phpdoc and IDEs.
$wgTransactionalTimeLimit
Config variable stub for the TransactionalTimeLimit setting, for use by phpdoc and IDEs.
$wgIllegalFileChars
Config variable stub for the IllegalFileChars setting, for use by phpdoc and IDEs.
$wgDirectoryMode
Config variable stub for the DirectoryMode setting, for use by phpdoc and IDEs.
$wgDiff3
Config variable stub for the Diff3 setting, for use by phpdoc and IDEs.
$wgUrlProtocols
Config variable stub for the UrlProtocols setting, for use by phpdoc and IDEs.
$wgResponsiveImages
Config variable stub for the ResponsiveImages setting, for use by phpdoc and IDEs.
$wgDebugRawPage
Config variable stub for the DebugRawPage setting, for use by phpdoc and IDEs.
$wgEnableMagicLinks
Config variable stub for the EnableMagicLinks setting, for use by phpdoc and IDEs.
$wgScriptPath
Config variable stub for the ScriptPath setting, for use by phpdoc and IDEs.
$wgExtensionDirectory
Config variable stub for the ExtensionDirectory setting, for use by phpdoc and IDEs.
$wgLoadScript
Config variable stub for the LoadScript setting, for use by phpdoc and IDEs.
$wgCanonicalServer
Config variable stub for the CanonicalServer setting, for use by phpdoc and IDEs.
$wgServer
Config variable stub for the Server setting, for use by phpdoc and IDEs.
$wgHttpsPort
Config variable stub for the HttpsPort setting, for use by phpdoc and IDEs.
foreach( $mmfl['setupFiles'] as $fileName) if( $queue) if(empty( $mmfl['quiet'])) $s
if(PHP_SAPI !='cli-server') if(!isset( $_SERVER['SCRIPT_FILENAME'])) $file
Item class for a filearchive table row.
if(!is_readable( $file)) $ext