MediaWiki  master
GlobalFunctions.php
Go to the documentation of this file.
1 <?php
23 if ( !defined( 'MEDIAWIKI' ) ) {
24  die( "This file is part of MediaWiki, it is not a valid entry point" );
25 }
26 
34 use Wikimedia\AtEase\AtEase;
35 use Wikimedia\WrappedString;
36 
47 function wfLoadExtension( $ext, $path = null ) {
48  if ( !$path ) {
49  global $wgExtensionDirectory;
50  $path = "$wgExtensionDirectory/$ext/extension.json";
51  }
53 }
54 
68 function wfLoadExtensions( array $exts ) {
69  global $wgExtensionDirectory;
70  $registry = ExtensionRegistry::getInstance();
71  foreach ( $exts as $ext ) {
72  $registry->queue( "$wgExtensionDirectory/$ext/extension.json" );
73  }
74 }
75 
84 function wfLoadSkin( $skin, $path = null ) {
85  if ( !$path ) {
86  global $wgStyleDirectory;
87  $path = "$wgStyleDirectory/$skin/skin.json";
88  }
90 }
91 
99 function wfLoadSkins( array $skins ) {
100  global $wgStyleDirectory;
101  $registry = ExtensionRegistry::getInstance();
102  foreach ( $skins as $skin ) {
103  $registry->queue( "$wgStyleDirectory/$skin/skin.json" );
104  }
105 }
106 
113 function wfArrayDiff2( $a, $b ) {
114  return array_udiff( $a, $b, 'wfArrayDiff2_cmp' );
115 }
116 
122 function wfArrayDiff2_cmp( $a, $b ) {
123  if ( is_string( $a ) && is_string( $b ) ) {
124  return strcmp( $a, $b );
125  } elseif ( count( $a ) !== count( $b ) ) {
126  return count( $a ) <=> count( $b );
127  } else {
128  reset( $a );
129  reset( $b );
130  while ( key( $a ) !== null && key( $b ) !== null ) {
131  $valueA = current( $a );
132  $valueB = current( $b );
133  $cmp = strcmp( $valueA, $valueB );
134  if ( $cmp !== 0 ) {
135  return $cmp;
136  }
137  next( $a );
138  next( $b );
139  }
140  return 0;
141  }
142 }
143 
153 function wfAppendToArrayIfNotDefault( $key, $value, $default, &$changed ) {
154  if ( is_null( $changed ) ) {
155  throw new MWException( 'GlobalFunctions::wfAppendToArrayIfNotDefault got null' );
156  }
157  if ( $default[$key] !== $value ) {
158  $changed[$key] = $value;
159  }
160 }
161 
181 function wfMergeErrorArrays( ...$args ) {
182  $out = [];
183  foreach ( $args as $errors ) {
184  foreach ( $errors as $params ) {
185  $originalParams = $params;
186  if ( $params[0] instanceof MessageSpecifier ) {
187  $msg = $params[0];
188  $params = array_merge( [ $msg->getKey() ], $msg->getParams() );
189  }
190  # @todo FIXME: Sometimes get nested arrays for $params,
191  # which leads to E_NOTICEs
192  $spec = implode( "\t", $params );
193  $out[$spec] = $originalParams;
194  }
195  }
196  return array_values( $out );
197 }
198 
207 function wfArrayInsertAfter( array $array, array $insert, $after ) {
208  // Find the offset of the element to insert after.
209  $keys = array_keys( $array );
210  $offsetByKey = array_flip( $keys );
211 
212  $offset = $offsetByKey[$after];
213 
214  // Insert at the specified offset
215  $before = array_slice( $array, 0, $offset + 1, true );
216  $after = array_slice( $array, $offset + 1, count( $array ) - $offset, true );
217 
218  $output = $before + $insert + $after;
219 
220  return $output;
221 }
222 
230 function wfObjectToArray( $objOrArray, $recursive = true ) {
231  $array = [];
232  if ( is_object( $objOrArray ) ) {
233  $objOrArray = get_object_vars( $objOrArray );
234  }
235  foreach ( $objOrArray as $key => $value ) {
236  if ( $recursive && ( is_object( $value ) || is_array( $value ) ) ) {
237  $value = wfObjectToArray( $value );
238  }
239 
240  $array[$key] = $value;
241  }
242 
243  return $array;
244 }
245 
256 function wfRandom() {
257  // The maximum random value is "only" 2^31-1, so get two random
258  // values to reduce the chance of dupes
259  $max = mt_getrandmax() + 1;
260  $rand = number_format( ( mt_rand() * $max + mt_rand() ) / $max / $max, 12, '.', '' );
261  return $rand;
262 }
263 
274 function wfRandomString( $length = 32 ) {
275  $str = '';
276  for ( $n = 0; $n < $length; $n += 7 ) {
277  $str .= sprintf( '%07x', mt_rand() & 0xfffffff );
278  }
279  return substr( $str, 0, $length );
280 }
281 
309 function wfUrlencode( $s ) {
310  static $needle;
311 
312  if ( is_null( $s ) ) {
313  // Reset $needle for testing.
314  $needle = null;
315  return '';
316  }
317 
318  if ( is_null( $needle ) ) {
319  $needle = [ '%3B', '%40', '%24', '%21', '%2A', '%28', '%29', '%2C', '%2F', '%7E' ];
320  if ( !isset( $_SERVER['SERVER_SOFTWARE'] ) ||
321  ( strpos( $_SERVER['SERVER_SOFTWARE'], 'Microsoft-IIS/7' ) === false )
322  ) {
323  $needle[] = '%3A';
324  }
325  }
326 
327  $s = urlencode( $s );
328  $s = str_ireplace(
329  $needle,
330  [ ';', '@', '$', '!', '*', '(', ')', ',', '/', '~', ':' ],
331  $s
332  );
333 
334  return $s;
335 }
336 
347 function wfArrayToCgi( $array1, $array2 = null, $prefix = '' ) {
348  if ( !is_null( $array2 ) ) {
349  $array1 = $array1 + $array2;
350  }
351 
352  $cgi = '';
353  foreach ( $array1 as $key => $value ) {
354  if ( !is_null( $value ) && $value !== false ) {
355  if ( $cgi != '' ) {
356  $cgi .= '&';
357  }
358  if ( $prefix !== '' ) {
359  $key = $prefix . "[$key]";
360  }
361  if ( is_array( $value ) ) {
362  $firstTime = true;
363  foreach ( $value as $k => $v ) {
364  $cgi .= $firstTime ? '' : '&';
365  if ( is_array( $v ) ) {
366  $cgi .= wfArrayToCgi( $v, null, $key . "[$k]" );
367  } else {
368  $cgi .= urlencode( $key . "[$k]" ) . '=' . urlencode( $v );
369  }
370  $firstTime = false;
371  }
372  } else {
373  if ( is_object( $value ) ) {
374  $value = $value->__toString();
375  }
376  $cgi .= urlencode( $key ) . '=' . urlencode( $value );
377  }
378  }
379  }
380  return $cgi;
381 }
382 
392 function wfCgiToArray( $query ) {
393  if ( isset( $query[0] ) && $query[0] == '?' ) {
394  $query = substr( $query, 1 );
395  }
396  $bits = explode( '&', $query );
397  $ret = [];
398  foreach ( $bits as $bit ) {
399  if ( $bit === '' ) {
400  continue;
401  }
402  if ( strpos( $bit, '=' ) === false ) {
403  // Pieces like &qwerty become 'qwerty' => '' (at least this is what php does)
404  $key = $bit;
405  $value = '';
406  } else {
407  list( $key, $value ) = explode( '=', $bit );
408  }
409  $key = urldecode( $key );
410  $value = urldecode( $value );
411  if ( strpos( $key, '[' ) !== false ) {
412  $keys = array_reverse( explode( '[', $key ) );
413  $key = array_pop( $keys );
414  $temp = $value;
415  foreach ( $keys as $k ) {
416  $k = substr( $k, 0, -1 );
417  $temp = [ $k => $temp ];
418  }
419  if ( isset( $ret[$key] ) ) {
420  $ret[$key] = array_merge( $ret[$key], $temp );
421  } else {
422  $ret[$key] = $temp;
423  }
424  } else {
425  $ret[$key] = $value;
426  }
427  }
428  return $ret;
429 }
430 
439 function wfAppendQuery( $url, $query ) {
440  if ( is_array( $query ) ) {
441  $query = wfArrayToCgi( $query );
442  }
443  if ( $query != '' ) {
444  // Remove the fragment, if there is one
445  $fragment = false;
446  $hashPos = strpos( $url, '#' );
447  if ( $hashPos !== false ) {
448  $fragment = substr( $url, $hashPos );
449  $url = substr( $url, 0, $hashPos );
450  }
451 
452  // Add parameter
453  if ( strpos( $url, '?' ) === false ) {
454  $url .= '?';
455  } else {
456  $url .= '&';
457  }
458  $url .= $query;
459 
460  // Put the fragment back
461  if ( $fragment !== false ) {
462  $url .= $fragment;
463  }
464  }
465  return $url;
466 }
467 
491 function wfExpandUrl( $url, $defaultProto = PROTO_CURRENT ) {
493  $wgHttpsPort;
494  if ( $defaultProto === PROTO_CANONICAL ) {
495  $serverUrl = $wgCanonicalServer;
496  } elseif ( $defaultProto === PROTO_INTERNAL && $wgInternalServer !== false ) {
497  // Make $wgInternalServer fall back to $wgServer if not set
498  $serverUrl = $wgInternalServer;
499  } else {
500  $serverUrl = $wgServer;
501  if ( $defaultProto === PROTO_CURRENT ) {
502  $defaultProto = $wgRequest->getProtocol() . '://';
503  }
504  }
505 
506  // Analyze $serverUrl to obtain its protocol
507  $bits = wfParseUrl( $serverUrl );
508  $serverHasProto = $bits && $bits['scheme'] != '';
509 
510  if ( $defaultProto === PROTO_CANONICAL || $defaultProto === PROTO_INTERNAL ) {
511  if ( $serverHasProto ) {
512  $defaultProto = $bits['scheme'] . '://';
513  } else {
514  // $wgCanonicalServer or $wgInternalServer doesn't have a protocol.
515  // This really isn't supposed to happen. Fall back to HTTP in this
516  // ridiculous case.
517  $defaultProto = PROTO_HTTP;
518  }
519  }
520 
521  $defaultProtoWithoutSlashes = $defaultProto !== null ? substr( $defaultProto, 0, -2 ) : '';
522 
523  if ( substr( $url, 0, 2 ) == '//' ) {
524  $url = $defaultProtoWithoutSlashes . $url;
525  } elseif ( substr( $url, 0, 1 ) == '/' ) {
526  // If $serverUrl is protocol-relative, prepend $defaultProtoWithoutSlashes,
527  // otherwise leave it alone.
528  if ( $serverHasProto ) {
529  $url = $serverUrl . $url;
530  } else {
531  // If an HTTPS URL is synthesized from a protocol-relative $wgServer, allow the
532  // user to override the port number (T67184)
533  if ( $defaultProto === PROTO_HTTPS && $wgHttpsPort != 443 ) {
534  if ( isset( $bits['port'] ) ) {
535  throw new Exception( 'A protocol-relative $wgServer may not contain a port number' );
536  }
537  $url = $defaultProtoWithoutSlashes . $serverUrl . ':' . $wgHttpsPort . $url;
538  } else {
539  $url = $defaultProtoWithoutSlashes . $serverUrl . $url;
540  }
541  }
542  }
543 
544  $bits = wfParseUrl( $url );
545 
546  if ( $bits && isset( $bits['path'] ) ) {
547  $bits['path'] = wfRemoveDotSegments( $bits['path'] );
548  return wfAssembleUrl( $bits );
549  } elseif ( $bits ) {
550  # No path to expand
551  return $url;
552  } elseif ( substr( $url, 0, 1 ) != '/' ) {
553  # URL is a relative path
554  return wfRemoveDotSegments( $url );
555  }
556 
557  # Expanded URL is not valid.
558  return false;
559 }
560 
569 function wfGetServerUrl( $proto ) {
570  $url = wfExpandUrl( '/', $proto );
571  return substr( $url, 0, -1 );
572 }
573 
587 function wfAssembleUrl( $urlParts ) {
588  $result = '';
589 
590  if ( isset( $urlParts['delimiter'] ) ) {
591  if ( isset( $urlParts['scheme'] ) ) {
592  $result .= $urlParts['scheme'];
593  }
594 
595  $result .= $urlParts['delimiter'];
596  }
597 
598  if ( isset( $urlParts['host'] ) ) {
599  if ( isset( $urlParts['user'] ) ) {
600  $result .= $urlParts['user'];
601  if ( isset( $urlParts['pass'] ) ) {
602  $result .= ':' . $urlParts['pass'];
603  }
604  $result .= '@';
605  }
606 
607  $result .= $urlParts['host'];
608 
609  if ( isset( $urlParts['port'] ) ) {
610  $result .= ':' . $urlParts['port'];
611  }
612  }
613 
614  if ( isset( $urlParts['path'] ) ) {
615  $result .= $urlParts['path'];
616  }
617 
618  if ( isset( $urlParts['query'] ) ) {
619  $result .= '?' . $urlParts['query'];
620  }
621 
622  if ( isset( $urlParts['fragment'] ) ) {
623  $result .= '#' . $urlParts['fragment'];
624  }
625 
626  return $result;
627 }
628 
641 function wfRemoveDotSegments( $urlPath ) {
642  $output = '';
643  $inputOffset = 0;
644  $inputLength = strlen( $urlPath );
645 
646  while ( $inputOffset < $inputLength ) {
647  $prefixLengthOne = substr( $urlPath, $inputOffset, 1 );
648  $prefixLengthTwo = substr( $urlPath, $inputOffset, 2 );
649  $prefixLengthThree = substr( $urlPath, $inputOffset, 3 );
650  $prefixLengthFour = substr( $urlPath, $inputOffset, 4 );
651  $trimOutput = false;
652 
653  if ( $prefixLengthTwo == './' ) {
654  # Step A, remove leading "./"
655  $inputOffset += 2;
656  } elseif ( $prefixLengthThree == '../' ) {
657  # Step A, remove leading "../"
658  $inputOffset += 3;
659  } elseif ( ( $prefixLengthTwo == '/.' ) && ( $inputOffset + 2 == $inputLength ) ) {
660  # Step B, replace leading "/.$" with "/"
661  $inputOffset += 1;
662  $urlPath[$inputOffset] = '/';
663  } elseif ( $prefixLengthThree == '/./' ) {
664  # Step B, replace leading "/./" with "/"
665  $inputOffset += 2;
666  } elseif ( $prefixLengthThree == '/..' && ( $inputOffset + 3 == $inputLength ) ) {
667  # Step C, replace leading "/..$" with "/" and
668  # remove last path component in output
669  $inputOffset += 2;
670  $urlPath[$inputOffset] = '/';
671  $trimOutput = true;
672  } elseif ( $prefixLengthFour == '/../' ) {
673  # Step C, replace leading "/../" with "/" and
674  # remove last path component in output
675  $inputOffset += 3;
676  $trimOutput = true;
677  } elseif ( ( $prefixLengthOne == '.' ) && ( $inputOffset + 1 == $inputLength ) ) {
678  # Step D, remove "^.$"
679  $inputOffset += 1;
680  } elseif ( ( $prefixLengthTwo == '..' ) && ( $inputOffset + 2 == $inputLength ) ) {
681  # Step D, remove "^..$"
682  $inputOffset += 2;
683  } else {
684  # Step E, move leading path segment to output
685  if ( $prefixLengthOne == '/' ) {
686  $slashPos = strpos( $urlPath, '/', $inputOffset + 1 );
687  } else {
688  $slashPos = strpos( $urlPath, '/', $inputOffset );
689  }
690  if ( $slashPos === false ) {
691  $output .= substr( $urlPath, $inputOffset );
692  $inputOffset = $inputLength;
693  } else {
694  $output .= substr( $urlPath, $inputOffset, $slashPos - $inputOffset );
695  $inputOffset += $slashPos - $inputOffset;
696  }
697  }
698 
699  if ( $trimOutput ) {
700  $slashPos = strrpos( $output, '/' );
701  if ( $slashPos === false ) {
702  $output = '';
703  } else {
704  $output = substr( $output, 0, $slashPos );
705  }
706  }
707  }
708 
709  return $output;
710 }
711 
719 function wfUrlProtocols( $includeProtocolRelative = true ) {
720  global $wgUrlProtocols;
721 
722  // Cache return values separately based on $includeProtocolRelative
723  static $withProtRel = null, $withoutProtRel = null;
724  $cachedValue = $includeProtocolRelative ? $withProtRel : $withoutProtRel;
725  if ( !is_null( $cachedValue ) ) {
726  return $cachedValue;
727  }
728 
729  // Support old-style $wgUrlProtocols strings, for backwards compatibility
730  // with LocalSettings files from 1.5
731  if ( is_array( $wgUrlProtocols ) ) {
732  $protocols = [];
733  foreach ( $wgUrlProtocols as $protocol ) {
734  // Filter out '//' if !$includeProtocolRelative
735  if ( $includeProtocolRelative || $protocol !== '//' ) {
736  $protocols[] = preg_quote( $protocol, '/' );
737  }
738  }
739 
740  $retval = implode( '|', $protocols );
741  } else {
742  // Ignore $includeProtocolRelative in this case
743  // This case exists for pre-1.6 compatibility, and we can safely assume
744  // that '//' won't appear in a pre-1.6 config because protocol-relative
745  // URLs weren't supported until 1.18
746  $retval = $wgUrlProtocols;
747  }
748 
749  // Cache return value
750  if ( $includeProtocolRelative ) {
751  $withProtRel = $retval;
752  } else {
753  $withoutProtRel = $retval;
754  }
755  return $retval;
756 }
757 
765  return wfUrlProtocols( false );
766 }
767 
793 function wfParseUrl( $url ) {
794  global $wgUrlProtocols; // Allow all protocols defined in DefaultSettings/LocalSettings.php
795 
796  // Protocol-relative URLs are handled really badly by parse_url(). It's so
797  // bad that the easiest way to handle them is to just prepend 'http:' and
798  // strip the protocol out later.
799  $wasRelative = substr( $url, 0, 2 ) == '//';
800  if ( $wasRelative ) {
801  $url = "http:$url";
802  }
803  AtEase::suppressWarnings();
804  $bits = parse_url( $url );
805  AtEase::restoreWarnings();
806  // parse_url() returns an array without scheme for some invalid URLs, e.g.
807  // parse_url("%0Ahttp://example.com") == [ 'host' => '%0Ahttp', 'path' => 'example.com' ]
808  if ( !$bits || !isset( $bits['scheme'] ) ) {
809  return false;
810  }
811 
812  // parse_url() incorrectly handles schemes case-sensitively. Convert it to lowercase.
813  $bits['scheme'] = strtolower( $bits['scheme'] );
814 
815  // most of the protocols are followed by ://, but mailto: and sometimes news: not, check for it
816  if ( in_array( $bits['scheme'] . '://', $wgUrlProtocols ) ) {
817  $bits['delimiter'] = '://';
818  } elseif ( in_array( $bits['scheme'] . ':', $wgUrlProtocols ) ) {
819  $bits['delimiter'] = ':';
820  // parse_url detects for news: and mailto: the host part of an url as path
821  // We have to correct this wrong detection
822  if ( isset( $bits['path'] ) ) {
823  $bits['host'] = $bits['path'];
824  $bits['path'] = '';
825  }
826  } else {
827  return false;
828  }
829 
830  /* Provide an empty host for eg. file:/// urls (see T30627) */
831  if ( !isset( $bits['host'] ) ) {
832  $bits['host'] = '';
833 
834  // See T47069
835  if ( isset( $bits['path'] ) ) {
836  /* parse_url loses the third / for file:///c:/ urls (but not on variants) */
837  if ( substr( $bits['path'], 0, 1 ) !== '/' ) {
838  $bits['path'] = '/' . $bits['path'];
839  }
840  } else {
841  $bits['path'] = '';
842  }
843  }
844 
845  // If the URL was protocol-relative, fix scheme and delimiter
846  if ( $wasRelative ) {
847  $bits['scheme'] = '';
848  $bits['delimiter'] = '//';
849  }
850  return $bits;
851 }
852 
863 function wfExpandIRI( $url ) {
864  return preg_replace_callback(
865  '/((?:%[89A-F][0-9A-F])+)/i',
866  function ( array $matches ) {
867  return urldecode( $matches[1] );
868  },
869  wfExpandUrl( $url )
870  );
871 }
872 
879 function wfMatchesDomainList( $url, $domains ) {
880  $bits = wfParseUrl( $url );
881  if ( is_array( $bits ) && isset( $bits['host'] ) ) {
882  $host = '.' . $bits['host'];
883  foreach ( (array)$domains as $domain ) {
884  $domain = '.' . $domain;
885  if ( substr( $host, -strlen( $domain ) ) === $domain ) {
886  return true;
887  }
888  }
889  }
890  return false;
891 }
892 
913 function wfDebug( $text, $dest = 'all', array $context = [] ) {
915  global $wgDebugTimestamps;
916 
917  if ( !$wgDebugRawPage && wfIsDebugRawPage() ) {
918  return;
919  }
920 
921  $text = trim( $text );
922 
923  if ( $wgDebugTimestamps ) {
924  $context['seconds_elapsed'] = sprintf(
925  '%6.4f',
926  microtime( true ) - $_SERVER['REQUEST_TIME_FLOAT']
927  );
928  $context['memory_used'] = sprintf(
929  '%5.1fM',
930  ( memory_get_usage( true ) / ( 1024 * 1024 ) )
931  );
932  }
933 
934  if ( $wgDebugLogPrefix !== '' ) {
935  $context['prefix'] = $wgDebugLogPrefix;
936  }
937  $context['private'] = ( $dest === false || $dest === 'private' );
938 
939  $logger = LoggerFactory::getInstance( 'wfDebug' );
940  $logger->debug( $text, $context );
941 }
942 
947 function wfIsDebugRawPage() {
948  static $cache;
949  if ( $cache !== null ) {
950  return $cache;
951  }
952  // Check for raw action using $_GET not $wgRequest, since the latter might not be initialised yet
953  // phpcs:ignore MediaWiki.Usage.SuperGlobalsUsage.SuperGlobals
954  if ( ( isset( $_GET['action'] ) && $_GET['action'] == 'raw' )
955  || (
956  isset( $_SERVER['SCRIPT_NAME'] )
957  && substr( $_SERVER['SCRIPT_NAME'], -8 ) == 'load.php'
958  )
959  ) {
960  $cache = true;
961  } else {
962  $cache = false;
963  }
964  return $cache;
965 }
966 
972 function wfDebugMem( $exact = false ) {
973  $mem = memory_get_usage();
974  if ( !$exact ) {
975  $mem = floor( $mem / 1024 ) . ' KiB';
976  } else {
977  $mem .= ' B';
978  }
979  wfDebug( "Memory usage: $mem\n" );
980 }
981 
1007 function wfDebugLog(
1008  $logGroup, $text, $dest = 'all', array $context = []
1009 ) {
1010  $text = trim( $text );
1011 
1012  $logger = LoggerFactory::getInstance( $logGroup );
1013  $context['private'] = ( $dest === false || $dest === 'private' );
1014  $logger->info( $text, $context );
1015 }
1016 
1025 function wfLogDBError( $text, array $context = [] ) {
1026  $logger = LoggerFactory::getInstance( 'wfLogDBError' );
1027  $logger->error( trim( $text ), $context );
1028 }
1029 
1044 function wfDeprecated( $function, $version = false, $component = false, $callerOffset = 2 ) {
1045  if ( is_string( $version ) || is_bool( $version ) ) {
1046  MWDebug::deprecated( $function, $version, $component, $callerOffset + 1 );
1047  } else {
1048  throw new Exception(
1049  "MediaWiki version must either be a string or a boolean. " .
1050  "Example valid version: '1.33'"
1051  );
1052  }
1053 }
1054 
1065 function wfWarn( $msg, $callerOffset = 1, $level = E_USER_NOTICE ) {
1066  MWDebug::warning( $msg, $callerOffset + 1, $level, 'auto' );
1067 }
1068 
1078 function wfLogWarning( $msg, $callerOffset = 1, $level = E_USER_WARNING ) {
1079  MWDebug::warning( $msg, $callerOffset + 1, $level, 'production' );
1080 }
1081 
1088 
1090  $request = $context->getRequest();
1091 
1092  $profiler = Profiler::instance();
1093  $profiler->setContext( $context );
1094  $profiler->logData();
1095 
1096  // Send out any buffered statsd metrics as needed
1098  MediaWikiServices::getInstance()->getStatsdDataFactory(),
1099  $context->getConfig()
1100  );
1101 
1102  // Profiling must actually be enabled...
1103  if ( $profiler instanceof ProfilerStub ) {
1104  return;
1105  }
1106 
1107  if ( isset( $wgDebugLogGroups['profileoutput'] )
1108  && $wgDebugLogGroups['profileoutput'] === false
1109  ) {
1110  // Explicitly disabled
1111  return;
1112  }
1113  if ( !$wgDebugRawPage && wfIsDebugRawPage() ) {
1114  return;
1115  }
1116 
1117  $ctx = [ 'elapsed' => $request->getElapsedTime() ];
1118  if ( !empty( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) {
1119  $ctx['forwarded_for'] = $_SERVER['HTTP_X_FORWARDED_FOR'];
1120  }
1121  if ( !empty( $_SERVER['HTTP_CLIENT_IP'] ) ) {
1122  $ctx['client_ip'] = $_SERVER['HTTP_CLIENT_IP'];
1123  }
1124  if ( !empty( $_SERVER['HTTP_FROM'] ) ) {
1125  $ctx['from'] = $_SERVER['HTTP_FROM'];
1126  }
1127  if ( isset( $ctx['forwarded_for'] ) ||
1128  isset( $ctx['client_ip'] ) ||
1129  isset( $ctx['from'] ) ) {
1130  $ctx['proxy'] = $_SERVER['REMOTE_ADDR'];
1131  }
1132 
1133  // Don't load $wgUser at this late stage just for statistics purposes
1134  // @todo FIXME: We can detect some anons even if it is not loaded.
1135  // See User::getId()
1136  $user = $context->getUser();
1137  $ctx['anon'] = $user->isItemLoaded( 'id' ) && $user->isAnon();
1138 
1139  // Command line script uses a FauxRequest object which does not have
1140  // any knowledge about an URL and throw an exception instead.
1141  try {
1142  $ctx['url'] = urldecode( $request->getRequestURL() );
1143  } catch ( Exception $ignored ) {
1144  // no-op
1145  }
1146 
1147  $ctx['output'] = $profiler->getOutput();
1148 
1149  $log = LoggerFactory::getInstance( 'profileoutput' );
1150  $log->info( "Elapsed: {elapsed}; URL: <{url}>\n{output}", $ctx );
1151 }
1152 
1160 function wfIncrStats( $key, $count = 1 ) {
1161  $stats = MediaWikiServices::getInstance()->getStatsdDataFactory();
1162  $stats->updateCount( $key, $count );
1163 }
1164 
1170 function wfReadOnly() {
1171  return MediaWikiServices::getInstance()->getReadOnlyMode()
1172  ->isReadOnly();
1173 }
1174 
1183 function wfReadOnlyReason() {
1184  return MediaWikiServices::getInstance()->getReadOnlyMode()
1185  ->getReason();
1186 }
1187 
1195  return MediaWikiServices::getInstance()->getConfiguredReadOnlyMode()
1196  ->getReason();
1197 }
1198 
1214 function wfGetLangObj( $langcode = false ) {
1215  # Identify which language to get or create a language object for.
1216  # Using is_object here due to Stub objects.
1217  if ( is_object( $langcode ) ) {
1218  # Great, we already have the object (hopefully)!
1219  return $langcode;
1220  }
1221 
1222  global $wgLanguageCode;
1223  if ( $langcode === true || $langcode === $wgLanguageCode ) {
1224  # $langcode is the language code of the wikis content language object.
1225  # or it is a boolean and value is true
1226  return MediaWikiServices::getInstance()->getContentLanguage();
1227  }
1228 
1229  global $wgLang;
1230  if ( $langcode === false || $langcode === $wgLang->getCode() ) {
1231  # $langcode is the language code of user language object.
1232  # or it was a boolean and value is false
1233  return $wgLang;
1234  }
1235 
1236  $validCodes = array_keys( Language::fetchLanguageNames() );
1237  if ( in_array( $langcode, $validCodes ) ) {
1238  # $langcode corresponds to a valid language.
1239  return MediaWikiServices::getInstance()->getLanguageFactory()->getLanguage( $langcode );
1240  }
1241 
1242  # $langcode is a string, but not a valid language code; use content language.
1243  wfDebug( "Invalid language code passed to wfGetLangObj, falling back to content language.\n" );
1244  return MediaWikiServices::getInstance()->getContentLanguage();
1245 }
1246 
1263 function wfMessage( $key, ...$params ) {
1264  $message = new Message( $key );
1265 
1266  // We call Message::params() to reduce code duplication
1267  if ( $params ) {
1268  $message->params( ...$params );
1269  }
1270 
1271  return $message;
1272 }
1273 
1286 function wfMessageFallback( ...$keys ) {
1287  return Message::newFallbackSequence( ...$keys );
1288 }
1289 
1298 function wfMsgReplaceArgs( $message, $args ) {
1299  # Fix windows line-endings
1300  # Some messages are split with explode("\n", $msg)
1301  $message = str_replace( "\r", '', $message );
1302 
1303  // Replace arguments
1304  if ( is_array( $args ) && $args ) {
1305  if ( is_array( $args[0] ) ) {
1306  $args = array_values( $args[0] );
1307  }
1308  $replacementKeys = [];
1309  foreach ( $args as $n => $param ) {
1310  $replacementKeys['$' . ( $n + 1 )] = $param;
1311  }
1312  $message = strtr( $message, $replacementKeys );
1313  }
1314 
1315  return $message;
1316 }
1317 
1325 function wfHostname() {
1326  static $host;
1327  if ( is_null( $host ) ) {
1328  # Hostname overriding
1329  global $wgOverrideHostname;
1330  if ( $wgOverrideHostname !== false ) {
1331  # Set static and skip any detection
1332  $host = $wgOverrideHostname;
1333  return $host;
1334  }
1335 
1336  if ( function_exists( 'posix_uname' ) ) {
1337  // This function not present on Windows
1338  $uname = posix_uname();
1339  } else {
1340  $uname = false;
1341  }
1342  if ( is_array( $uname ) && isset( $uname['nodename'] ) ) {
1343  $host = $uname['nodename'];
1344  } elseif ( getenv( 'COMPUTERNAME' ) ) {
1345  # Windows computer name
1346  $host = getenv( 'COMPUTERNAME' );
1347  } else {
1348  # This may be a virtual server.
1349  $host = $_SERVER['SERVER_NAME'];
1350  }
1351  }
1352  return $host;
1353 }
1354 
1365 function wfReportTime( $nonce = null ) {
1366  global $wgShowHostnames;
1367 
1368  $elapsed = ( microtime( true ) - $_SERVER['REQUEST_TIME_FLOAT'] );
1369  // seconds to milliseconds
1370  $responseTime = round( $elapsed * 1000 );
1371  $reportVars = [ 'wgBackendResponseTime' => $responseTime ];
1372  if ( $wgShowHostnames ) {
1373  $reportVars['wgHostname'] = wfHostname();
1374  }
1375  return Skin::makeVariablesScript( $reportVars, $nonce );
1376 }
1377 
1388 function wfDebugBacktrace( $limit = 0 ) {
1389  static $disabled = null;
1390 
1391  if ( is_null( $disabled ) ) {
1392  $disabled = !function_exists( 'debug_backtrace' );
1393  if ( $disabled ) {
1394  wfDebug( "debug_backtrace() is disabled\n" );
1395  }
1396  }
1397  if ( $disabled ) {
1398  return [];
1399  }
1400 
1401  if ( $limit ) {
1402  return array_slice( debug_backtrace( DEBUG_BACKTRACE_PROVIDE_OBJECT, $limit + 1 ), 1 );
1403  } else {
1404  return array_slice( debug_backtrace(), 1 );
1405  }
1406 }
1407 
1416 function wfBacktrace( $raw = null ) {
1417  global $wgCommandLineMode;
1418 
1419  if ( $raw === null ) {
1420  $raw = $wgCommandLineMode;
1421  }
1422 
1423  if ( $raw ) {
1424  $frameFormat = "%s line %s calls %s()\n";
1425  $traceFormat = "%s";
1426  } else {
1427  $frameFormat = "<li>%s line %s calls %s()</li>\n";
1428  $traceFormat = "<ul>\n%s</ul>\n";
1429  }
1430 
1431  $frames = array_map( function ( $frame ) use ( $frameFormat ) {
1432  $file = !empty( $frame['file'] ) ? basename( $frame['file'] ) : '-';
1433  $line = $frame['line'] ?? '-';
1434  $call = $frame['function'];
1435  if ( !empty( $frame['class'] ) ) {
1436  $call = $frame['class'] . $frame['type'] . $call;
1437  }
1438  return sprintf( $frameFormat, $file, $line, $call );
1439  }, wfDebugBacktrace() );
1440 
1441  return sprintf( $traceFormat, implode( '', $frames ) );
1442 }
1443 
1453 function wfGetCaller( $level = 2 ) {
1454  $backtrace = wfDebugBacktrace( $level + 1 );
1455  if ( isset( $backtrace[$level] ) ) {
1456  return wfFormatStackFrame( $backtrace[$level] );
1457  } else {
1458  return 'unknown';
1459  }
1460 }
1461 
1469 function wfGetAllCallers( $limit = 3 ) {
1470  $trace = array_reverse( wfDebugBacktrace() );
1471  if ( !$limit || $limit > count( $trace ) - 1 ) {
1472  $limit = count( $trace ) - 1;
1473  }
1474  $trace = array_slice( $trace, -$limit - 1, $limit );
1475  return implode( '/', array_map( 'wfFormatStackFrame', $trace ) );
1476 }
1477 
1484 function wfFormatStackFrame( $frame ) {
1485  if ( !isset( $frame['function'] ) ) {
1486  return 'NO_FUNCTION_GIVEN';
1487  }
1488  return isset( $frame['class'] ) && isset( $frame['type'] ) ?
1489  $frame['class'] . $frame['type'] . $frame['function'] :
1490  $frame['function'];
1491 }
1492 
1493 /* Some generic result counters, pulled out of SearchEngine */
1494 
1502 function wfShowingResults( $offset, $limit ) {
1503  return wfMessage( 'showingresults' )->numParams( $limit, $offset + 1 )->parse();
1504 }
1505 
1515 function wfClientAcceptsGzip( $force = false ) {
1516  static $result = null;
1517  if ( $result === null || $force ) {
1518  $result = false;
1519  if ( isset( $_SERVER['HTTP_ACCEPT_ENCODING'] ) ) {
1520  # @todo FIXME: We may want to blacklist some broken browsers
1521  $m = [];
1522  if ( preg_match(
1523  '/\bgzip(?:;(q)=([0-9]+(?:\.[0-9]+)))?\b/',
1524  $_SERVER['HTTP_ACCEPT_ENCODING'],
1525  $m
1526  )
1527  ) {
1528  if ( isset( $m[2] ) && ( $m[1] == 'q' ) && ( $m[2] == 0 ) ) {
1529  $result = false;
1530  return $result;
1531  }
1532  wfDebug( "wfClientAcceptsGzip: client accepts gzip.\n" );
1533  $result = true;
1534  }
1535  }
1536  }
1537  return $result;
1538 }
1539 
1550 function wfEscapeWikiText( $text ) {
1551  global $wgEnableMagicLinks;
1552  static $repl = null, $repl2 = null;
1553  if ( $repl === null || defined( 'MW_PARSER_TEST' ) || defined( 'MW_PHPUNIT_TEST' ) ) {
1554  // Tests depend upon being able to change $wgEnableMagicLinks, so don't cache
1555  // in those situations
1556  $repl = [
1557  '"' => '&#34;', '&' => '&#38;', "'" => '&#39;', '<' => '&#60;',
1558  '=' => '&#61;', '>' => '&#62;', '[' => '&#91;', ']' => '&#93;',
1559  '{' => '&#123;', '|' => '&#124;', '}' => '&#125;', ';' => '&#59;',
1560  "\n#" => "\n&#35;", "\r#" => "\r&#35;",
1561  "\n*" => "\n&#42;", "\r*" => "\r&#42;",
1562  "\n:" => "\n&#58;", "\r:" => "\r&#58;",
1563  "\n " => "\n&#32;", "\r " => "\r&#32;",
1564  "\n\n" => "\n&#10;", "\r\n" => "&#13;\n",
1565  "\n\r" => "\n&#13;", "\r\r" => "\r&#13;",
1566  "\n\t" => "\n&#9;", "\r\t" => "\r&#9;", // "\n\t\n" is treated like "\n\n"
1567  "\n----" => "\n&#45;---", "\r----" => "\r&#45;---",
1568  '__' => '_&#95;', '://' => '&#58;//',
1569  ];
1570 
1571  $magicLinks = array_keys( array_filter( $wgEnableMagicLinks ) );
1572  // We have to catch everything "\s" matches in PCRE
1573  foreach ( $magicLinks as $magic ) {
1574  $repl["$magic "] = "$magic&#32;";
1575  $repl["$magic\t"] = "$magic&#9;";
1576  $repl["$magic\r"] = "$magic&#13;";
1577  $repl["$magic\n"] = "$magic&#10;";
1578  $repl["$magic\f"] = "$magic&#12;";
1579  }
1580 
1581  // And handle protocols that don't use "://"
1582  global $wgUrlProtocols;
1583  $repl2 = [];
1584  foreach ( $wgUrlProtocols as $prot ) {
1585  if ( substr( $prot, -1 ) === ':' ) {
1586  $repl2[] = preg_quote( substr( $prot, 0, -1 ), '/' );
1587  }
1588  }
1589  $repl2 = $repl2 ? '/\b(' . implode( '|', $repl2 ) . '):/i' : '/^(?!)/';
1590  }
1591  $text = substr( strtr( "\n$text", $repl ), 1 );
1592  $text = preg_replace( $repl2, '$1&#58;', $text );
1593  return $text;
1594 }
1595 
1606 function wfSetVar( &$dest, $source, $force = false ) {
1607  $temp = $dest;
1608  if ( !is_null( $source ) || $force ) {
1609  $dest = $source;
1610  }
1611  return $temp;
1612 }
1613 
1623 function wfSetBit( &$dest, $bit, $state = true ) {
1624  $temp = (bool)( $dest & $bit );
1625  if ( !is_null( $state ) ) {
1626  if ( $state ) {
1627  $dest |= $bit;
1628  } else {
1629  $dest &= ~$bit;
1630  }
1631  }
1632  return $temp;
1633 }
1634 
1641 function wfVarDump( $var ) {
1642  global $wgOut;
1643  $s = str_replace( "\n", "<br />\n", var_export( $var, true ) . "\n" );
1644  if ( headers_sent() || !isset( $wgOut ) || !is_object( $wgOut ) ) {
1645  print $s;
1646  } else {
1647  $wgOut->addHTML( $s );
1648  }
1649 }
1650 
1658 function wfHttpError( $code, $label, $desc ) {
1659  global $wgOut;
1660  HttpStatus::header( $code );
1661  if ( $wgOut ) {
1662  $wgOut->disable();
1663  $wgOut->sendCacheControl();
1664  }
1665 
1667  header( 'Content-type: text/html; charset=utf-8' );
1668  ob_start();
1669  print '<!DOCTYPE html>' .
1670  '<html><head><title>' .
1671  htmlspecialchars( $label ) .
1672  '</title></head><body><h1>' .
1673  htmlspecialchars( $label ) .
1674  '</h1><p>' .
1675  nl2br( htmlspecialchars( $desc ) ) .
1676  "</p></body></html>\n";
1677  header( 'Content-Length: ' . ob_get_length() );
1678  ob_end_flush();
1679 }
1680 
1698 function wfResetOutputBuffers( $resetGzipEncoding = true ) {
1699  if ( $resetGzipEncoding ) {
1700  // Suppress Content-Encoding and Content-Length
1701  // headers from OutputHandler::handle.
1704  }
1705  while ( $status = ob_get_status() ) {
1706  if ( isset( $status['flags'] ) ) {
1707  $flags = PHP_OUTPUT_HANDLER_CLEANABLE | PHP_OUTPUT_HANDLER_REMOVABLE;
1708  $deleteable = ( $status['flags'] & $flags ) === $flags;
1709  } elseif ( isset( $status['del'] ) ) {
1710  $deleteable = $status['del'];
1711  } else {
1712  // Guess that any PHP-internal setting can't be removed.
1713  $deleteable = $status['type'] !== 0; /* PHP_OUTPUT_HANDLER_INTERNAL */
1714  }
1715  if ( !$deleteable ) {
1716  // Give up, and hope the result doesn't break
1717  // output behavior.
1718  break;
1719  }
1720  if ( $status['name'] === 'MediaWikiIntegrationTestCase::wfResetOutputBuffersBarrier' ) {
1721  // Unit testing barrier to prevent this function from breaking PHPUnit.
1722  break;
1723  }
1724  if ( !ob_end_clean() ) {
1725  // Could not remove output buffer handler; abort now
1726  // to avoid getting in some kind of infinite loop.
1727  break;
1728  }
1729  if ( $resetGzipEncoding && $status['name'] == 'ob_gzhandler' ) {
1730  // Reset the 'Content-Encoding' field set by this handler
1731  // so we can start fresh.
1732  header_remove( 'Content-Encoding' );
1733  break;
1734  }
1735  }
1736 }
1737 
1751  wfResetOutputBuffers( false );
1752 }
1753 
1762 function wfAcceptToPrefs( $accept, $def = '*/*' ) {
1763  # No arg means accept anything (per HTTP spec)
1764  if ( !$accept ) {
1765  return [ $def => 1.0 ];
1766  }
1767 
1768  $prefs = [];
1769 
1770  $parts = explode( ',', $accept );
1771 
1772  foreach ( $parts as $part ) {
1773  # @todo FIXME: Doesn't deal with params like 'text/html; level=1'
1774  $values = explode( ';', trim( $part ) );
1775  $match = [];
1776  if ( count( $values ) == 1 ) {
1777  $prefs[$values[0]] = 1.0;
1778  } elseif ( preg_match( '/q\s*=\s*(\d*\.\d+)/', $values[1], $match ) ) {
1779  $prefs[$values[0]] = floatval( $match[1] );
1780  }
1781  }
1782 
1783  return $prefs;
1784 }
1785 
1798 function mimeTypeMatch( $type, $avail ) {
1799  if ( array_key_exists( $type, $avail ) ) {
1800  return $type;
1801  } else {
1802  $mainType = explode( '/', $type )[0];
1803  if ( array_key_exists( "$mainType/*", $avail ) ) {
1804  return "$mainType/*";
1805  } elseif ( array_key_exists( '*/*', $avail ) ) {
1806  return '*/*';
1807  } else {
1808  return null;
1809  }
1810  }
1811 }
1812 
1827 function wfNegotiateType( $cprefs, $sprefs ) {
1828  $combine = [];
1829 
1830  foreach ( array_keys( $sprefs ) as $type ) {
1831  $subType = explode( '/', $type )[1];
1832  if ( $subType != '*' ) {
1833  $ckey = mimeTypeMatch( $type, $cprefs );
1834  if ( $ckey ) {
1835  $combine[$type] = $sprefs[$type] * $cprefs[$ckey];
1836  }
1837  }
1838  }
1839 
1840  foreach ( array_keys( $cprefs ) as $type ) {
1841  $subType = explode( '/', $type )[1];
1842  if ( $subType != '*' && !array_key_exists( $type, $sprefs ) ) {
1843  $skey = mimeTypeMatch( $type, $sprefs );
1844  if ( $skey ) {
1845  $combine[$type] = $sprefs[$skey] * $cprefs[$type];
1846  }
1847  }
1848  }
1849 
1850  $bestq = 0;
1851  $besttype = null;
1852 
1853  foreach ( array_keys( $combine ) as $type ) {
1854  if ( $combine[$type] > $bestq ) {
1855  $besttype = $type;
1856  $bestq = $combine[$type];
1857  }
1858  }
1859 
1860  return $besttype;
1861 }
1862 
1871 function wfTimestamp( $outputtype = TS_UNIX, $ts = 0 ) {
1872  $ret = MWTimestamp::convert( $outputtype, $ts );
1873  if ( $ret === false ) {
1874  wfDebug( "wfTimestamp() fed bogus time value: TYPE=$outputtype; VALUE=$ts\n" );
1875  }
1876  return $ret;
1877 }
1878 
1887 function wfTimestampOrNull( $outputtype = TS_UNIX, $ts = null ) {
1888  if ( is_null( $ts ) ) {
1889  return null;
1890  } else {
1891  return wfTimestamp( $outputtype, $ts );
1892  }
1893 }
1894 
1900 function wfTimestampNow() {
1901  return MWTimestamp::now( TS_MW );
1902 }
1903 
1909 function wfIsWindows() {
1910  static $isWindows = null;
1911  if ( $isWindows === null ) {
1912  $isWindows = strtoupper( substr( PHP_OS, 0, 3 ) ) === 'WIN';
1913  }
1914  return $isWindows;
1915 }
1916 
1923 function wfIsHHVM() {
1924  wfDeprecated( __FUNCTION__, '1.34' );
1925  return false;
1926 }
1927 
1934 function wfIsCLI() {
1935  return PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg';
1936 }
1937 
1949 function wfTempDir() {
1950  global $wgTmpDirectory;
1951 
1952  if ( $wgTmpDirectory !== false ) {
1953  return $wgTmpDirectory;
1954  }
1955 
1957 }
1958 
1968 function wfMkdirParents( $dir, $mode = null, $caller = null ) {
1969  global $wgDirectoryMode;
1970 
1971  if ( FileBackend::isStoragePath( $dir ) ) { // sanity
1972  throw new MWException( __FUNCTION__ . " given storage path '$dir'." );
1973  }
1974 
1975  if ( !is_null( $caller ) ) {
1976  wfDebug( "$caller: called wfMkdirParents($dir)\n" );
1977  }
1978 
1979  if ( strval( $dir ) === '' || is_dir( $dir ) ) {
1980  return true;
1981  }
1982 
1983  $dir = str_replace( [ '\\', '/' ], DIRECTORY_SEPARATOR, $dir );
1984 
1985  if ( is_null( $mode ) ) {
1986  $mode = $wgDirectoryMode;
1987  }
1988 
1989  // Turn off the normal warning, we're doing our own below
1990  AtEase::suppressWarnings();
1991  $ok = mkdir( $dir, $mode, true ); // PHP5 <3
1992  AtEase::restoreWarnings();
1993 
1994  if ( !$ok ) {
1995  // directory may have been created on another request since we last checked
1996  if ( is_dir( $dir ) ) {
1997  return true;
1998  }
1999 
2000  // PHP doesn't report the path in its warning message, so add our own to aid in diagnosis.
2001  wfLogWarning( sprintf( "failed to mkdir \"%s\" mode 0%o", $dir, $mode ) );
2002  }
2003  return $ok;
2004 }
2005 
2011 function wfRecursiveRemoveDir( $dir ) {
2012  wfDebug( __FUNCTION__ . "( $dir )\n" );
2013  // taken from https://www.php.net/manual/en/function.rmdir.php#98622
2014  if ( is_dir( $dir ) ) {
2015  $objects = scandir( $dir );
2016  foreach ( $objects as $object ) {
2017  if ( $object != "." && $object != ".." ) {
2018  if ( filetype( $dir . '/' . $object ) == "dir" ) {
2019  wfRecursiveRemoveDir( $dir . '/' . $object );
2020  } else {
2021  unlink( $dir . '/' . $object );
2022  }
2023  }
2024  }
2025  reset( $objects );
2026  rmdir( $dir );
2027  }
2028 }
2029 
2036 function wfPercent( $nr, $acc = 2, $round = true ) {
2037  $ret = sprintf( "%.${acc}f", $nr );
2038  return $round ? round( (float)$ret, $acc ) . '%' : "$ret%";
2039 }
2040 
2064 function wfIniGetBool( $setting ) {
2065  return wfStringToBool( ini_get( $setting ) );
2066 }
2067 
2080 function wfStringToBool( $val ) {
2081  $val = strtolower( $val );
2082  // 'on' and 'true' can't have whitespace around them, but '1' can.
2083  return $val == 'on'
2084  || $val == 'true'
2085  || $val == 'yes'
2086  || preg_match( "/^\s*[+-]?0*[1-9]/", $val ); // approx C atoi() function
2087 }
2088 
2101 function wfEscapeShellArg( ...$args ) {
2102  return Shell::escape( ...$args );
2103 }
2104 
2129 function wfShellExec( $cmd, &$retval = null, $environ = [],
2130  $limits = [], $options = []
2131 ) {
2132  if ( Shell::isDisabled() ) {
2133  $retval = 1;
2134  // Backwards compatibility be upon us...
2135  return 'Unable to run external programs, proc_open() is disabled.';
2136  }
2137 
2138  if ( is_array( $cmd ) ) {
2139  $cmd = Shell::escape( $cmd );
2140  }
2141 
2142  $includeStderr = isset( $options['duplicateStderr'] ) && $options['duplicateStderr'];
2143  $profileMethod = $options['profileMethod'] ?? wfGetCaller();
2144 
2145  try {
2146  $result = Shell::command( [] )
2147  ->unsafeParams( (array)$cmd )
2148  ->environment( $environ )
2149  ->limits( $limits )
2150  ->includeStderr( $includeStderr )
2151  ->profileMethod( $profileMethod )
2152  // For b/c
2153  ->restrict( Shell::RESTRICT_NONE )
2154  ->execute();
2155  } catch ( ProcOpenError $ex ) {
2156  $retval = -1;
2157  return '';
2158  }
2159 
2160  $retval = $result->getExitCode();
2161 
2162  return $result->getStdout();
2163 }
2164 
2182 function wfShellExecWithStderr( $cmd, &$retval = null, $environ = [], $limits = [] ) {
2183  return wfShellExec( $cmd, $retval, $environ, $limits,
2184  [ 'duplicateStderr' => true, 'profileMethod' => wfGetCaller() ] );
2185 }
2186 
2202 function wfShellWikiCmd( $script, array $parameters = [], array $options = [] ) {
2203  global $wgPhpCli;
2204  // Give site config file a chance to run the script in a wrapper.
2205  // The caller may likely want to call wfBasename() on $script.
2206  Hooks::run( 'wfShellWikiCmd', [ &$script, &$parameters, &$options ] );
2207  $cmd = [ $options['php'] ?? $wgPhpCli ];
2208  if ( isset( $options['wrapper'] ) ) {
2209  $cmd[] = $options['wrapper'];
2210  }
2211  $cmd[] = $script;
2212  // Escape each parameter for shell
2213  return Shell::escape( array_merge( $cmd, $parameters ) );
2214 }
2215 
2227 function wfMerge( $old, $mine, $yours, &$result, &$mergeAttemptResult = null ) {
2228  global $wgDiff3;
2229 
2230  # This check may also protect against code injection in
2231  # case of broken installations.
2232  AtEase::suppressWarnings();
2233  $haveDiff3 = $wgDiff3 && file_exists( $wgDiff3 );
2234  AtEase::restoreWarnings();
2235 
2236  if ( !$haveDiff3 ) {
2237  wfDebug( "diff3 not found\n" );
2238  return false;
2239  }
2240 
2241  # Make temporary files
2242  $td = wfTempDir();
2243  $oldtextFile = fopen( $oldtextName = tempnam( $td, 'merge-old-' ), 'w' );
2244  $mytextFile = fopen( $mytextName = tempnam( $td, 'merge-mine-' ), 'w' );
2245  $yourtextFile = fopen( $yourtextName = tempnam( $td, 'merge-your-' ), 'w' );
2246 
2247  # NOTE: diff3 issues a warning to stderr if any of the files does not end with
2248  # a newline character. To avoid this, we normalize the trailing whitespace before
2249  # creating the diff.
2250 
2251  fwrite( $oldtextFile, rtrim( $old ) . "\n" );
2252  fclose( $oldtextFile );
2253  fwrite( $mytextFile, rtrim( $mine ) . "\n" );
2254  fclose( $mytextFile );
2255  fwrite( $yourtextFile, rtrim( $yours ) . "\n" );
2256  fclose( $yourtextFile );
2257 
2258  # Check for a conflict
2259  $cmd = Shell::escape( $wgDiff3, '-a', '--overlap-only', $mytextName,
2260  $oldtextName, $yourtextName );
2261  $handle = popen( $cmd, 'r' );
2262 
2263  $mergeAttemptResult = '';
2264  do {
2265  $data = fread( $handle, 8192 );
2266  if ( strlen( $data ) == 0 ) {
2267  break;
2268  }
2269  $mergeAttemptResult .= $data;
2270  } while ( true );
2271  pclose( $handle );
2272 
2273  $conflict = $mergeAttemptResult !== '';
2274 
2275  # Merge differences
2276  $cmd = Shell::escape( $wgDiff3, '-a', '-e', '--merge', $mytextName,
2277  $oldtextName, $yourtextName );
2278  $handle = popen( $cmd, 'r' );
2279  $result = '';
2280  do {
2281  $data = fread( $handle, 8192 );
2282  if ( strlen( $data ) == 0 ) {
2283  break;
2284  }
2285  $result .= $data;
2286  } while ( true );
2287  pclose( $handle );
2288  unlink( $mytextName );
2289  unlink( $oldtextName );
2290  unlink( $yourtextName );
2291 
2292  if ( $result === '' && $old !== '' && !$conflict ) {
2293  wfDebug( "Unexpected null result from diff3. Command: $cmd\n" );
2294  $conflict = true;
2295  }
2296  return !$conflict;
2297 }
2298 
2310 function wfDiff( $before, $after, $params = '-u' ) {
2311  if ( $before == $after ) {
2312  return '';
2313  }
2314 
2315  global $wgDiff;
2316  AtEase::suppressWarnings();
2317  $haveDiff = $wgDiff && file_exists( $wgDiff );
2318  AtEase::restoreWarnings();
2319 
2320  # This check may also protect against code injection in
2321  # case of broken installations.
2322  if ( !$haveDiff ) {
2323  wfDebug( "diff executable not found\n" );
2324  $diffs = new Diff( explode( "\n", $before ), explode( "\n", $after ) );
2325  $format = new UnifiedDiffFormatter();
2326  return $format->format( $diffs );
2327  }
2328 
2329  # Make temporary files
2330  $td = wfTempDir();
2331  $oldtextFile = fopen( $oldtextName = tempnam( $td, 'merge-old-' ), 'w' );
2332  $newtextFile = fopen( $newtextName = tempnam( $td, 'merge-your-' ), 'w' );
2333 
2334  fwrite( $oldtextFile, $before );
2335  fclose( $oldtextFile );
2336  fwrite( $newtextFile, $after );
2337  fclose( $newtextFile );
2338 
2339  // Get the diff of the two files
2340  $cmd = "$wgDiff " . $params . ' ' . Shell::escape( $oldtextName, $newtextName );
2341 
2342  $h = popen( $cmd, 'r' );
2343  if ( !$h ) {
2344  unlink( $oldtextName );
2345  unlink( $newtextName );
2346  throw new Exception( __FUNCTION__ . '(): popen() failed' );
2347  }
2348 
2349  $diff = '';
2350 
2351  do {
2352  $data = fread( $h, 8192 );
2353  if ( strlen( $data ) == 0 ) {
2354  break;
2355  }
2356  $diff .= $data;
2357  } while ( true );
2358 
2359  // Clean up
2360  pclose( $h );
2361  unlink( $oldtextName );
2362  unlink( $newtextName );
2363 
2364  // Kill the --- and +++ lines. They're not useful.
2365  $diff_lines = explode( "\n", $diff );
2366  if ( isset( $diff_lines[0] ) && strpos( $diff_lines[0], '---' ) === 0 ) {
2367  unset( $diff_lines[0] );
2368  }
2369  if ( isset( $diff_lines[1] ) && strpos( $diff_lines[1], '+++' ) === 0 ) {
2370  unset( $diff_lines[1] );
2371  }
2372 
2373  $diff = implode( "\n", $diff_lines );
2374 
2375  return $diff;
2376 }
2377 
2390 function wfBaseName( $path, $suffix = '' ) {
2391  if ( $suffix == '' ) {
2392  $encSuffix = '';
2393  } else {
2394  $encSuffix = '(?:' . preg_quote( $suffix, '#' ) . ')?';
2395  }
2396 
2397  $matches = [];
2398  if ( preg_match( "#([^/\\\\]*?){$encSuffix}[/\\\\]*$#", $path, $matches ) ) {
2399  return $matches[1];
2400  } else {
2401  return '';
2402  }
2403 }
2404 
2414 function wfRelativePath( $path, $from ) {
2415  // Normalize mixed input on Windows...
2416  $path = str_replace( '/', DIRECTORY_SEPARATOR, $path );
2417  $from = str_replace( '/', DIRECTORY_SEPARATOR, $from );
2418 
2419  // Trim trailing slashes -- fix for drive root
2420  $path = rtrim( $path, DIRECTORY_SEPARATOR );
2421  $from = rtrim( $from, DIRECTORY_SEPARATOR );
2422 
2423  $pieces = explode( DIRECTORY_SEPARATOR, dirname( $path ) );
2424  $against = explode( DIRECTORY_SEPARATOR, $from );
2425 
2426  if ( $pieces[0] !== $against[0] ) {
2427  // Non-matching Windows drive letters?
2428  // Return a full path.
2429  return $path;
2430  }
2431 
2432  // Trim off common prefix
2433  while ( count( $pieces ) && count( $against )
2434  && $pieces[0] == $against[0] ) {
2435  array_shift( $pieces );
2436  array_shift( $against );
2437  }
2438 
2439  // relative dots to bump us to the parent
2440  while ( count( $against ) ) {
2441  array_unshift( $pieces, '..' );
2442  array_shift( $against );
2443  }
2444 
2445  array_push( $pieces, wfBaseName( $path ) );
2446 
2447  return implode( DIRECTORY_SEPARATOR, $pieces );
2448 }
2449 
2459 function wfSetupSession( $sessionId = false ) {
2460  wfDeprecated( __FUNCTION__, '1.27' );
2461 
2462  if ( $sessionId ) {
2463  session_id( $sessionId );
2464  }
2465 
2466  $session = SessionManager::getGlobalSession();
2467  $session->persist();
2468 
2469  if ( session_id() !== $session->getId() ) {
2470  session_id( $session->getId() );
2471  }
2472  AtEase::quietCall( 'session_start' );
2473 }
2474 
2481 function wfGetPrecompiledData( $name ) {
2482  global $IP;
2483 
2484  $file = "$IP/serialized/$name";
2485  if ( file_exists( $file ) ) {
2486  $blob = file_get_contents( $file );
2487  if ( $blob ) {
2488  return unserialize( $blob );
2489  }
2490  }
2491  return false;
2492 }
2493 
2501 function wfMemcKey( ...$args ) {
2502  return ObjectCache::getLocalClusterInstance()->makeKey( ...$args );
2503 }
2504 
2515 function wfForeignMemcKey( $db, $prefix, ...$args ) {
2516  $keyspace = $prefix ? "$db-$prefix" : $db;
2517  return ObjectCache::getLocalClusterInstance()->makeKeyInternal( $keyspace, $args );
2518 }
2519 
2532 function wfGlobalCacheKey( ...$args ) {
2533  wfDeprecated( __FUNCTION__, '1.30' );
2534  return ObjectCache::getLocalClusterInstance()->makeGlobalKey( ...$args );
2535 }
2536 
2544 function wfWikiID() {
2545  global $wgDBprefix, $wgDBname;
2546 
2547  if ( $wgDBprefix ) {
2548  return "$wgDBname-$wgDBprefix";
2549  } else {
2550  return $wgDBname;
2551  }
2552 }
2553 
2579 function wfGetDB( $db, $groups = [], $wiki = false ) {
2580  return wfGetLB( $wiki )->getMaintenanceConnectionRef( $db, $groups, $wiki );
2581 }
2582 
2592 function wfGetLB( $wiki = false ) {
2593  if ( $wiki === false ) {
2594  return MediaWikiServices::getInstance()->getDBLoadBalancer();
2595  } else {
2596  $factory = MediaWikiServices::getInstance()->getDBLoadBalancerFactory();
2597  return $factory->getMainLB( $wiki );
2598  }
2599 }
2600 
2608 function wfFindFile( $title, $options = [] ) {
2609  return MediaWikiServices::getInstance()->getRepoGroup()->findFile( $title, $options );
2610 }
2611 
2620 function wfLocalFile( $title ) {
2621  return MediaWikiServices::getInstance()->getRepoGroup()->getLocalRepo()->newFile( $title );
2622 }
2623 
2631  global $wgMiserMode;
2632  return $wgMiserMode
2633  || ( SiteStats::pages() > 100000
2634  && SiteStats::edits() > 1000000
2635  && SiteStats::users() > 10000 );
2636 }
2637 
2646 function wfScript( $script = 'index' ) {
2648  if ( $script === 'index' ) {
2649  return $wgScript;
2650  } elseif ( $script === 'load' ) {
2651  return $wgLoadScript;
2652  } else {
2653  return "{$wgScriptPath}/{$script}.php";
2654  }
2655 }
2656 
2662 function wfGetScriptUrl() {
2663  if ( isset( $_SERVER['SCRIPT_NAME'] ) ) {
2664  /* as it was called, minus the query string.
2665  *
2666  * Some sites use Apache rewrite rules to handle subdomains,
2667  * and have PHP set up in a weird way that causes PHP_SELF
2668  * to contain the rewritten URL instead of the one that the
2669  * outside world sees.
2670  *
2671  * If in this mode, use SCRIPT_URL instead, which mod_rewrite
2672  * provides containing the "before" URL.
2673  */
2674  return $_SERVER['SCRIPT_NAME'];
2675  } else {
2676  return $_SERVER['URL'];
2677  }
2678 }
2679 
2687 function wfBoolToStr( $value ) {
2688  return $value ? 'true' : 'false';
2689 }
2690 
2696 function wfGetNull() {
2697  return wfIsWindows() ? 'NUL' : '/dev/null';
2698 }
2699 
2723  $ifWritesSince = null, $wiki = false, $cluster = false, $timeout = null
2724 ) {
2725  $lbFactory = MediaWikiServices::getInstance()->getDBLoadBalancerFactory();
2726 
2727  if ( $cluster === '*' ) {
2728  $cluster = false;
2729  $domain = false;
2730  } elseif ( $wiki === false ) {
2731  $domain = $lbFactory->getLocalDomainID();
2732  } else {
2733  $domain = $wiki;
2734  }
2735 
2736  $opts = [
2737  'domain' => $domain,
2738  'cluster' => $cluster,
2739  // B/C: first argument used to be "max seconds of lag"; ignore such values
2740  'ifWritesSince' => ( $ifWritesSince > 1e9 ) ? $ifWritesSince : null
2741  ];
2742  if ( $timeout !== null ) {
2743  $opts['timeout'] = $timeout;
2744  }
2745 
2746  return $lbFactory->waitForReplication( $opts );
2747 }
2748 
2757 function wfStripIllegalFilenameChars( $name ) {
2758  global $wgIllegalFileChars;
2759  $illegalFileChars = $wgIllegalFileChars ? "|[" . $wgIllegalFileChars . "]" : '';
2760  $name = preg_replace(
2761  "/[^" . Title::legalChars() . "]" . $illegalFileChars . "/",
2762  '-',
2763  $name
2764  );
2765  // $wgIllegalFileChars may not include '/' and '\', so we still need to do this
2766  $name = wfBaseName( $name );
2767  return $name;
2768 }
2769 
2776 function wfMemoryLimit( $newLimit ) {
2777  $oldLimit = wfShorthandToInteger( ini_get( 'memory_limit' ) );
2778  // If the INI config is already unlimited, there is nothing larger
2779  if ( $oldLimit != -1 ) {
2780  $newLimit = wfShorthandToInteger( $newLimit );
2781  if ( $newLimit == -1 ) {
2782  wfDebug( "Removing PHP's memory limit\n" );
2783  Wikimedia\suppressWarnings();
2784  ini_set( 'memory_limit', $newLimit );
2785  Wikimedia\restoreWarnings();
2786  } elseif ( $newLimit > $oldLimit ) {
2787  wfDebug( "Raising PHP's memory limit to $newLimit bytes\n" );
2788  Wikimedia\suppressWarnings();
2789  ini_set( 'memory_limit', $newLimit );
2790  Wikimedia\restoreWarnings();
2791  }
2792  }
2793 }
2794 
2803 
2804  $timeLimit = (int)ini_get( 'max_execution_time' );
2805  // Note that CLI scripts use 0
2806  if ( $timeLimit > 0 && $wgTransactionalTimeLimit > $timeLimit ) {
2807  set_time_limit( $wgTransactionalTimeLimit );
2808  }
2809 
2810  ignore_user_abort( true ); // ignore client disconnects
2811 
2812  return $timeLimit;
2813 }
2814 
2822 function wfShorthandToInteger( $string = '', $default = -1 ) {
2823  $string = trim( $string );
2824  if ( $string === '' ) {
2825  return $default;
2826  }
2827  $last = $string[strlen( $string ) - 1];
2828  $val = intval( $string );
2829  switch ( $last ) {
2830  case 'g':
2831  case 'G':
2832  $val *= 1024;
2833  // break intentionally missing
2834  case 'm':
2835  case 'M':
2836  $val *= 1024;
2837  // break intentionally missing
2838  case 'k':
2839  case 'K':
2840  $val *= 1024;
2841  }
2842 
2843  return $val;
2844 }
2845 
2853 function wfGetCache( $cacheType ) {
2854  return ObjectCache::getInstance( $cacheType );
2855 }
2856 
2863 function wfGetMainCache() {
2865 }
2866 
2873  global $wgMessageCacheType;
2875 }
2876 
2891 function wfUnpack( $format, $data, $length = false ) {
2892  if ( $length !== false ) {
2893  $realLen = strlen( $data );
2894  if ( $realLen < $length ) {
2895  throw new MWException( "Tried to use wfUnpack on a "
2896  . "string of length $realLen, but needed one "
2897  . "of at least length $length."
2898  );
2899  }
2900  }
2901 
2902  Wikimedia\suppressWarnings();
2903  $result = unpack( $format, $data );
2904  Wikimedia\restoreWarnings();
2905 
2906  if ( $result === false ) {
2907  // If it cannot extract the packed data.
2908  throw new MWException( "unpack could not unpack binary data" );
2909  }
2910  return $result;
2911 }
2912 
2929 function wfIsBadImage( $name, $contextTitle = false, $blacklist = null ) {
2930  $services = MediaWikiServices::getInstance();
2931  if ( $blacklist !== null ) {
2932  wfDeprecated( __FUNCTION__ . ' with $blacklist parameter', '1.34' );
2933  return ( new BadFileLookup(
2934  function () use ( $blacklist ) {
2935  return $blacklist;
2936  },
2937  $services->getLocalServerObjectCache(),
2938  $services->getRepoGroup(),
2939  $services->getTitleParser()
2940  ) )->isBadFile( $name, $contextTitle ?: null );
2941  }
2942  return $services->getBadFileLookup()->isBadFile( $name, $contextTitle ?: null );
2943 }
2944 
2952 function wfCanIPUseHTTPS( $ip ) {
2953  $canDo = true;
2954  Hooks::run( 'CanIPUseHTTPS', [ $ip, &$canDo ] );
2955  return (bool)$canDo;
2956 }
2957 
2965 function wfIsInfinity( $str ) {
2966  // These are hardcoded elsewhere in MediaWiki (e.g. mediawiki.special.block.js).
2967  $infinityValues = [ 'infinite', 'indefinite', 'infinity', 'never' ];
2968  return in_array( $str, $infinityValues );
2969 }
2970 
2985 function wfThumbIsStandard( File $file, array $params ) {
2987 
2988  $multipliers = [ 1 ];
2989  if ( $wgResponsiveImages ) {
2990  // These available sizes are hardcoded currently elsewhere in MediaWiki.
2991  // @see Linker::processResponsiveImages
2992  $multipliers[] = 1.5;
2993  $multipliers[] = 2;
2994  }
2995 
2996  $handler = $file->getHandler();
2997  if ( !$handler || !isset( $params['width'] ) ) {
2998  return false;
2999  }
3000 
3001  $basicParams = [];
3002  if ( isset( $params['page'] ) ) {
3003  $basicParams['page'] = $params['page'];
3004  }
3005 
3006  $thumbLimits = [];
3007  $imageLimits = [];
3008  // Expand limits to account for multipliers
3009  foreach ( $multipliers as $multiplier ) {
3010  $thumbLimits = array_merge( $thumbLimits, array_map(
3011  function ( $width ) use ( $multiplier ) {
3012  return round( $width * $multiplier );
3013  }, $wgThumbLimits )
3014  );
3015  $imageLimits = array_merge( $imageLimits, array_map(
3016  function ( $pair ) use ( $multiplier ) {
3017  return [
3018  round( $pair[0] * $multiplier ),
3019  round( $pair[1] * $multiplier ),
3020  ];
3021  }, $wgImageLimits )
3022  );
3023  }
3024 
3025  // Check if the width matches one of $wgThumbLimits
3026  if ( in_array( $params['width'], $thumbLimits ) ) {
3027  $normalParams = $basicParams + [ 'width' => $params['width'] ];
3028  // Append any default values to the map (e.g. "lossy", "lossless", ...)
3029  $handler->normaliseParams( $file, $normalParams );
3030  } else {
3031  // If not, then check if the width matchs one of $wgImageLimits
3032  $match = false;
3033  foreach ( $imageLimits as $pair ) {
3034  $normalParams = $basicParams + [ 'width' => $pair[0], 'height' => $pair[1] ];
3035  // Decide whether the thumbnail should be scaled on width or height.
3036  // Also append any default values to the map (e.g. "lossy", "lossless", ...)
3037  $handler->normaliseParams( $file, $normalParams );
3038  // Check if this standard thumbnail size maps to the given width
3039  if ( $normalParams['width'] == $params['width'] ) {
3040  $match = true;
3041  break;
3042  }
3043  }
3044  if ( !$match ) {
3045  return false; // not standard for description pages
3046  }
3047  }
3048 
3049  // Check that the given values for non-page, non-width, params are just defaults
3050  foreach ( $params as $key => $value ) {
3051  if ( !isset( $normalParams[$key] ) || $normalParams[$key] != $value ) {
3052  return false;
3053  }
3054  }
3055 
3056  return true;
3057 }
3058 
3071 function wfArrayPlus2d( array $baseArray, array $newValues ) {
3072  // First merge items that are in both arrays
3073  foreach ( $baseArray as $name => &$groupVal ) {
3074  if ( isset( $newValues[$name] ) ) {
3075  $groupVal += $newValues[$name];
3076  }
3077  }
3078  // Now add items that didn't exist yet
3079  $baseArray += $newValues;
3080 
3081  return $baseArray;
3082 }
3083 
3093 function wfGetRusage() {
3094  wfDeprecated( __FUNCTION__, '1.35' );
3095  return getrusage( 0 /* RUSAGE_SELF */ );
3096 }
$wgPhpCli
$wgPhpCli
Executable path of the PHP cli binary.
Definition: DefaultSettings.php:8324
wfArrayInsertAfter
wfArrayInsertAfter(array $array, array $insert, $after)
Insert array into another array after the specified KEY
Definition: GlobalFunctions.php:207
MediaWiki\Shell\Shell
Executes shell commands.
Definition: Shell.php:44
wfMergeErrorArrays
wfMergeErrorArrays(... $args)
Merge arrays in the style of getUserPermissionsErrors, with duplicate removal e.g.
Definition: GlobalFunctions.php:181
wfPercent
wfPercent( $nr, $acc=2, $round=true)
Definition: GlobalFunctions.php:2036
wfResetOutputBuffers
wfResetOutputBuffers( $resetGzipEncoding=true)
Clear away any user-level output buffers, discarding contents.
Definition: GlobalFunctions.php:1698
wfMessageFallback
wfMessageFallback(... $keys)
This function accepts multiple message keys and returns a message instance for the first message whic...
Definition: GlobalFunctions.php:1286
$wgThumbLimits
$wgThumbLimits
Adjust thumbnails on image pages according to a user setting.
Definition: DefaultSettings.php:1474
PROTO_CANONICAL
const PROTO_CANONICAL
Definition: Defines.php:203
wfCanIPUseHTTPS
wfCanIPUseHTTPS( $ip)
Determine whether the client at a given source IP is likely to be able to access the wiki via HTTPS.
Definition: GlobalFunctions.php:2952
ObjectCache\getLocalClusterInstance
static getLocalClusterInstance()
Get the main cluster-local cache object.
Definition: ObjectCache.php:267
SiteStats\users
static users()
Definition: SiteStats.php:121
MediaWiki\emitBufferedStatsdData
static emitBufferedStatsdData(IBufferingStatsdDataFactory $stats, Config $config)
Send out any buffered statsd data according to sampling rules.
Definition: MediaWiki.php:1073
PROTO_INTERNAL
const PROTO_INTERNAL
Definition: Defines.php:204
MediaWiki\ProcOpenError
Definition: ProcOpenError.php:25
wfDiff
wfDiff( $before, $after, $params='-u')
Returns unified plain-text diff of two texts.
Definition: GlobalFunctions.php:2310
$wgResponsiveImages
$wgResponsiveImages
Generate and use thumbnails suitable for screens with 1.5 and 2.0 pixel densities.
Definition: DefaultSettings.php:1593
wfSetupSession
wfSetupSession( $sessionId=false)
Initialise php session.
Definition: GlobalFunctions.php:2459
$wgDebugRawPage
$wgDebugRawPage
If true, log debugging data from action=raw and load.php.
Definition: DefaultSettings.php:6138
wfThumbIsStandard
wfThumbIsStandard(File $file, array $params)
Returns true if these thumbnail parameters match one that MediaWiki requests from file description pa...
Definition: GlobalFunctions.php:2985
$wgTmpDirectory
$wgTmpDirectory
The local filesystem path to a temporary directory.
Definition: DefaultSettings.php:352
wfArrayPlus2d
wfArrayPlus2d(array $baseArray, array $newValues)
Merges two (possibly) 2 dimensional arrays into the target array ($baseArray).
Definition: GlobalFunctions.php:3071
$wgDBname
$wgDBname
Current wiki database name.
Definition: DefaultSettings.php:1893
Profiler\instance
static instance()
Singleton.
Definition: Profiler.php:63
wfMkdirParents
wfMkdirParents( $dir, $mode=null, $caller=null)
Make directory, and make all parent directories if they don't exist.
Definition: GlobalFunctions.php:1968
MediaWiki\MediaWikiServices
MediaWikiServices is the service locator for the application scope of MediaWiki.
Definition: MediaWikiServices.php:129
MediaWiki\BadFileLookup
Definition: BadFileLookup.php:12
$wgDiff3
$wgDiff3
Path to the GNU diff3 utility.
Definition: DefaultSettings.php:6662
wfMerge
wfMerge( $old, $mine, $yours, &$result, &$mergeAttemptResult=null)
wfMerge attempts to merge differences between three texts.
Definition: GlobalFunctions.php:2227
wfDebugBacktrace
wfDebugBacktrace( $limit=0)
Safety wrapper for debug_backtrace().
Definition: GlobalFunctions.php:1388
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 val...
Definition: GlobalFunctions.php:1606
wfGetLB
wfGetLB( $wiki=false)
Get a load balancer object.
Definition: GlobalFunctions.php:2592
wfFormatStackFrame
wfFormatStackFrame( $frame)
Return a string representation of frame.
Definition: GlobalFunctions.php:1484
wfRemoveDotSegments
wfRemoveDotSegments( $urlPath)
Remove all dot-segments in the provided URL path.
Definition: GlobalFunctions.php:641
$wgScript
$wgScript
The URL path to index.php.
Definition: DefaultSettings.php:185
wfSetBit
wfSetBit(&$dest, $bit, $state=true)
As for wfSetVar except setting a bit.
Definition: GlobalFunctions.php:1623
Skin\makeVariablesScript
static makeVariablesScript( $data, $nonce=null)
Definition: Skin.php:402
wfNegotiateType
wfNegotiateType( $cprefs, $sprefs)
Returns the 'best' match between a client's requested internet media types and the server's list of a...
Definition: GlobalFunctions.php:1827
wfTimestamp
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
Definition: GlobalFunctions.php:1871
SiteStats\pages
static pages()
Definition: SiteStats.php:112
wfUnpack
wfUnpack( $format, $data, $length=false)
Wrapper around php's unpack.
Definition: GlobalFunctions.php:2891
wfConfiguredReadOnlyReason
wfConfiguredReadOnlyReason()
Get the value of $wgReadOnly or the contents of $wgReadOnlyFile.
Definition: GlobalFunctions.php:1194
MessageSpecifier
Definition: MessageSpecifier.php:21
$wgShowHostnames
$wgShowHostnames
Expose backend server host names through the API and various HTML comments.
Definition: DefaultSettings.php:6336
wfMemoryLimit
wfMemoryLimit( $newLimit)
Raise PHP's memory limit (if needed).
Definition: GlobalFunctions.php:2776
wfObjectToArray
wfObjectToArray( $objOrArray, $recursive=true)
Recursively converts the parameter (an object) to an array with the same data.
Definition: GlobalFunctions.php:230
wfUrlencode
wfUrlencode( $s)
We want some things to be included as literal characters in our title URLs for prettiness,...
Definition: GlobalFunctions.php:309
wfArrayDiff2_cmp
wfArrayDiff2_cmp( $a, $b)
Definition: GlobalFunctions.php:122
wfGetScriptUrl
wfGetScriptUrl()
Get the script URL.
Definition: GlobalFunctions.php:2662
$wgMessageCacheType
$wgMessageCacheType
The cache type for storing the contents of the MediaWiki namespace.
Definition: DefaultSettings.php:2348
ProfilerStub
Stub profiler that does nothing.
Definition: ProfilerStub.php:29
$wgDiff
$wgDiff
Path to the GNU diff utility.
Definition: DefaultSettings.php:6667
wfBaseName
wfBaseName( $path, $suffix='')
Return the final portion of a pathname.
Definition: GlobalFunctions.php:2390
wfQueriesMustScale
wfQueriesMustScale()
Should low-performance queries be disabled?
Definition: GlobalFunctions.php:2630
$file
if(PHP_SAPI !='cli-server') if(!isset( $_SERVER['SCRIPT_FILENAME'])) $file
Item class for a filearchive table row.
Definition: router.php:42
wfHostname
wfHostname()
Fetch server name for use in error reporting etc.
Definition: GlobalFunctions.php:1325
wfReadOnly
wfReadOnly()
Check whether the wiki is in read-only mode.
Definition: GlobalFunctions.php:1170
wfMsgReplaceArgs
wfMsgReplaceArgs( $message, $args)
Replace message parameter keys on the given formatted output.
Definition: GlobalFunctions.php:1298
wfMessage
wfMessage( $key,... $params)
This is the function for getting translated interface messages.
Definition: GlobalFunctions.php:1263
$s
$s
Definition: mergeMessageFileList.php:185
wfLogWarning
wfLogWarning( $msg, $callerOffset=1, $level=E_USER_WARNING)
Send a warning as a PHP error and the debug log.
Definition: GlobalFunctions.php:1078
wfStringToBool
wfStringToBool( $val)
Convert string value to boolean, when the following are interpreted as true:
Definition: GlobalFunctions.php:2080
$wgTransactionalTimeLimit
$wgTransactionalTimeLimit
The minimum amount of time that MediaWiki needs for "slow" write request, particularly ones with mult...
Definition: DefaultSettings.php:2304
Message
$wgDebugLogPrefix
$wgDebugLogPrefix
Prefix for debug log lines.
Definition: DefaultSettings.php:6124
wfExpandIRI
wfExpandIRI( $url)
Take a URL, make sure it's expanded to fully qualified, and replace any encoded non-ASCII Unicode cha...
Definition: GlobalFunctions.php:863
wfWaitForSlaves
wfWaitForSlaves( $ifWritesSince=null, $wiki=false, $cluster=false, $timeout=null)
Waits for the replica DBs to catch up to the master position.
Definition: GlobalFunctions.php:2722
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.
Definition: GlobalFunctions.php:1007
$wgDBprefix
$wgDBprefix
Current wiki database table name prefix.
Definition: DefaultSettings.php:1913
wfShellWikiCmd
wfShellWikiCmd( $script, array $parameters=[], array $options=[])
Generate a shell-escaped command line string to run a MediaWiki cli script.
Definition: GlobalFunctions.php:2202
wfBoolToStr
wfBoolToStr( $value)
Convenience function converts boolean values into "true" or "false" (string) values.
Definition: GlobalFunctions.php:2687
wfAppendQuery
wfAppendQuery( $url, $query)
Append a query string to an existing URL, which may or may not already have query string parameters a...
Definition: GlobalFunctions.php:439
ExtensionRegistry\getInstance
static getInstance()
Definition: ExtensionRegistry.php:127
wfParseUrl
wfParseUrl( $url)
parse_url() work-alike, but non-broken.
Definition: GlobalFunctions.php:793
File
Implements some public methods and some protected utility functions which are required by multiple ch...
Definition: File.php:61
wfReportTime
wfReportTime( $nonce=null)
Returns a script tag that stores the amount of time it took MediaWiki to handle the request in millis...
Definition: GlobalFunctions.php:1365
wfGetMainCache
wfGetMainCache()
Get the main cache object.
Definition: GlobalFunctions.php:2863
MWException
MediaWiki exception.
Definition: MWException.php:26
wfStripIllegalFilenameChars
wfStripIllegalFilenameChars( $name)
Replace all invalid characters with '-'.
Definition: GlobalFunctions.php:2757
wfGetRusage
wfGetRusage()
Get system resource usage of current request context.
Definition: GlobalFunctions.php:3093
mimeTypeMatch
mimeTypeMatch( $type, $avail)
Checks if a given MIME type matches any of the keys in the given array.
Definition: GlobalFunctions.php:1798
wfDeprecated
wfDeprecated( $function, $version=false, $component=false, $callerOffset=2)
Throws a warning that $function is deprecated.
Definition: GlobalFunctions.php:1044
MediaWiki\Logger\LoggerFactory
PSR-3 logger instance factory.
Definition: LoggerFactory.php:45
wfScript
wfScript( $script='index')
Get the path to a specified script file, respecting file extensions; this is a wrapper around $wgScri...
Definition: GlobalFunctions.php:2646
wfArrayDiff2
wfArrayDiff2( $a, $b)
Like array_diff( $a, $b ) except that it works with two-dimensional arrays.
Definition: GlobalFunctions.php:113
wfIncrStats
wfIncrStats( $key, $count=1)
Increment a statistics counter.
Definition: GlobalFunctions.php:1160
FileBackend\isStoragePath
static isStoragePath( $path)
Check if a given path is a "mwstore://" path.
Definition: FileBackend.php:1517
$blob
$blob
Definition: testCompression.php:67
wfTransactionalTimeLimit
wfTransactionalTimeLimit()
Set PHP's time limit to the larger of php.ini or $wgTransactionalTimeLimit.
Definition: GlobalFunctions.php:2801
wfGetDB
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
Definition: GlobalFunctions.php:2579
wfUrlProtocolsWithoutProtRel
wfUrlProtocolsWithoutProtRel()
Like wfUrlProtocols(), but excludes '//' from the protocol list.
Definition: GlobalFunctions.php:764
$wgCommandLineMode
global $wgCommandLineMode
Definition: DevelopmentSettings.php:28
$matches
$matches
Definition: NoLocalSettings.php:24
$wgDebugLogGroups
$wgDebugLogGroups
Map of string log group names to log destinations.
Definition: DefaultSettings.php:6247
$wgLang
$wgLang
Definition: Setup.php:858
$wgLoadScript
$wgLoadScript
The URL path to load.php.
Definition: DefaultSettings.php:193
wfTimestampOrNull
wfTimestampOrNull( $outputtype=TS_UNIX, $ts=null)
Return a formatted timestamp, or null if input is null.
Definition: GlobalFunctions.php:1887
PROTO_CURRENT
const PROTO_CURRENT
Definition: Defines.php:202
ObjectCache\getInstance
static getInstance( $id)
Get a cached instance of the specified type of cache object.
Definition: ObjectCache.php:78
$args
if( $line===false) $args
Definition: mcc.php:124
wfGetLangObj
wfGetLangObj( $langcode=false)
Return a Language object from $langcode.
Definition: GlobalFunctions.php:1214
wfCgiToArray
wfCgiToArray( $query)
This is the logical opposite of wfArrayToCgi(): it accepts a query string as its argument and returns...
Definition: GlobalFunctions.php:392
wfLoadSkins
wfLoadSkins(array $skins)
Load multiple skins at once.
Definition: GlobalFunctions.php:99
$title
$title
Definition: testCompression.php:36
MWDebug\deprecated
static deprecated( $function, $version=false, $component=false, $callerOffset=2)
Show a warning that $function is deprecated.
Definition: MWDebug.php:217
wfGetCache
wfGetCache( $cacheType)
Get a specific cache object.
Definition: GlobalFunctions.php:2853
$wgEnableMagicLinks
$wgEnableMagicLinks
Enable the magic links feature of automatically turning ISBN xxx, PMID xxx, RFC xxx into links.
Definition: DefaultSettings.php:4352
wfTimestampNow
wfTimestampNow()
Convenience function; returns MediaWiki timestamp for the present time.
Definition: GlobalFunctions.php:1900
wfDebug
wfDebug( $text, $dest='all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
Definition: GlobalFunctions.php:913
wfAcceptToPrefs
wfAcceptToPrefs( $accept, $def=' */*')
Converts an Accept-* header into an array mapping string values to quality factors.
Definition: GlobalFunctions.php:1762
PROTO_HTTPS
const PROTO_HTTPS
Definition: Defines.php:200
$wgCanonicalServer
$wgCanonicalServer
Canonical URL of the server, to use in IRC feeds and notification e-mails.
Definition: DefaultSettings.php:114
wfIsDebugRawPage
wfIsDebugRawPage()
Returns true if debug logging should be suppressed if $wgDebugRawPage = false.
Definition: GlobalFunctions.php:947
wfForeignMemcKey
wfForeignMemcKey( $db, $prefix,... $args)
Make a cache key for a foreign DB.
Definition: GlobalFunctions.php:2515
UnifiedDiffFormatter
A formatter that outputs unified diffs.
Definition: UnifiedDiffFormatter.php:31
$wgDebugTimestamps
$wgDebugTimestamps
Prefix debug messages with relative timestamp.
Definition: DefaultSettings.php:6285
wfUrlProtocols
wfUrlProtocols( $includeProtocolRelative=true)
Returns a regular expression of url protocols.
Definition: GlobalFunctions.php:719
wfIsBadImage
wfIsBadImage( $name, $contextTitle=false, $blacklist=null)
Determine if an image exists on the 'bad image list'.
Definition: GlobalFunctions.php:2929
wfLoadExtensions
wfLoadExtensions(array $exts)
Load multiple extensions at once.
Definition: GlobalFunctions.php:68
wfGlobalCacheKey
wfGlobalCacheKey(... $args)
Make a cache key with database-agnostic prefix.
Definition: GlobalFunctions.php:2532
wfWikiID
wfWikiID()
Get an ASCII string identifying this wiki This is used as a prefix in memcached keys.
Definition: GlobalFunctions.php:2544
wfClearOutputBuffers
wfClearOutputBuffers()
More legible than passing a 'false' parameter to wfResetOutputBuffers():
Definition: GlobalFunctions.php:1750
wfClientAcceptsGzip
wfClientAcceptsGzip( $force=false)
Whether the client accept gzip encoding.
Definition: GlobalFunctions.php:1515
$wgUrlProtocols
$wgUrlProtocols
URL schemes that should be recognized as valid by wfParseUrl().
Definition: DefaultSettings.php:4189
$wgExtensionDirectory
$wgExtensionDirectory
Filesystem extensions directory.
Definition: DefaultSettings.php:229
wfIsCLI
wfIsCLI()
Check if we are running from the commandline.
Definition: GlobalFunctions.php:1934
wfIsWindows
wfIsWindows()
Check if the operating system is Windows.
Definition: GlobalFunctions.php:1909
$wgServer
$wgServer
URL of the server.
Definition: DefaultSettings.php:105
MediaWiki\Session\SessionManager
This serves as the entry point to the MediaWiki session handling system.
Definition: SessionManager.php:50
$line
$line
Definition: mcc.php:119
$wgLanguageCode
$wgLanguageCode
Site language code.
Definition: DefaultSettings.php:2949
wfIsInfinity
wfIsInfinity( $str)
Determine input string is represents as infinity.
Definition: GlobalFunctions.php:2965
wfDebugMem
wfDebugMem( $exact=false)
Send a line giving PHP memory usage.
Definition: GlobalFunctions.php:972
PROTO_HTTP
const PROTO_HTTP
Definition: Defines.php:199
$wgDirectoryMode
$wgDirectoryMode
Default value for chmoding of new directories.
Definition: DefaultSettings.php:1585
wfEscapeWikiText
wfEscapeWikiText( $text)
Escapes the given text so that it may be output using addWikiText() without any linking,...
Definition: GlobalFunctions.php:1550
wfAppendToArrayIfNotDefault
wfAppendToArrayIfNotDefault( $key, $value, $default, &$changed)
Appends to second array if $value differs from that in $default.
Definition: GlobalFunctions.php:153
$wgDisableOutputCompression
$wgDisableOutputCompression
Disable output compression (enabled by default if zlib is available)
Definition: DefaultSettings.php:3423
wfVarDump
wfVarDump( $var)
A wrapper around the PHP function var_export().
Definition: GlobalFunctions.php:1641
$wgIllegalFileChars
$wgIllegalFileChars
Additional characters that are not allowed in filenames.
Definition: DefaultSettings.php:431
wfGetNull
wfGetNull()
Get a platform-independent path to the null file, e.g.
Definition: GlobalFunctions.php:2696
TempFSFile\getUsableTempDirectory
static getUsableTempDirectory()
Definition: TempFSFile.php:80
RequestContext\getMain
static getMain()
Get the RequestContext object associated with the main request.
Definition: RequestContext.php:445
wfIniGetBool
wfIniGetBool( $setting)
Safety wrapper around ini_get() for boolean settings.
Definition: GlobalFunctions.php:2064
$wgOverrideHostname
$wgOverrideHostname
Override server hostname detection with a hardcoded value.
Definition: DefaultSettings.php:6343
wfFindFile
wfFindFile( $title, $options=[])
Find a file.
Definition: GlobalFunctions.php:2608
$context
$context
Definition: load.php:40
wfGetAllCallers
wfGetAllCallers( $limit=3)
Return a string consisting of callers in the stack.
Definition: GlobalFunctions.php:1469
wfLoadExtension
wfLoadExtension( $ext, $path=null)
Load an extension.
Definition: GlobalFunctions.php:47
wfGetMessageCacheStorage
wfGetMessageCacheStorage()
Get the cache object used by the message cache.
Definition: GlobalFunctions.php:2872
unserialize
unserialize( $serialized)
Definition: ApiMessageTrait.php:146
wfLoadSkin
wfLoadSkin( $skin, $path=null)
Load a skin.
Definition: GlobalFunctions.php:84
wfShorthandToInteger
wfShorthandToInteger( $string='', $default=-1)
Converts shorthand byte notation to integer form.
Definition: GlobalFunctions.php:2822
$wgImageLimits
$wgImageLimits
Limit images on image description pages to a user-selectable limit.
Definition: DefaultSettings.php:1461
wfRandom
wfRandom()
Get a random decimal value in the domain of [0, 1), in a way not likely to give duplicate values for ...
Definition: GlobalFunctions.php:256
wfTempDir
wfTempDir()
Tries to get the system directory for temporary files.
Definition: GlobalFunctions.php:1949
$wgMiserMode
$wgMiserMode
Disable database-intensive features.
Definition: DefaultSettings.php:2260
wfHttpError
wfHttpError( $code, $label, $desc)
Provide a simple HTTP error.
Definition: GlobalFunctions.php:1658
wfReadOnlyReason
wfReadOnlyReason()
Check if the site is in read-only mode and return the message if so.
Definition: GlobalFunctions.php:1183
wfMatchesDomainList
wfMatchesDomainList( $url, $domains)
Check whether a given URL has a domain that occurs in a given set of domains.
Definition: GlobalFunctions.php:879
$cache
$cache
Definition: mcc.php:33
HttpStatus\header
static header( $code)
Output an HTTP status code header.
Definition: HttpStatus.php:96
wfGetPrecompiledData
wfGetPrecompiledData( $name)
Get an object from the precompiled serialized directory.
Definition: GlobalFunctions.php:2481
wfRecursiveRemoveDir
wfRecursiveRemoveDir( $dir)
Remove a directory and all its content.
Definition: GlobalFunctions.php:2011
$wgHttpsPort
$wgHttpsPort
For installations where the canonical server is HTTP but HTTPS is optionally supported,...
Definition: DefaultSettings.php:8659
$path
$path
Definition: NoLocalSettings.php:25
$keys
$keys
Definition: testCompression.php:69
wfBacktrace
wfBacktrace( $raw=null)
Get a debug backtrace as a string.
Definition: GlobalFunctions.php:1416
wfEscapeShellArg
wfEscapeShellArg(... $args)
Version of escapeshellarg() that works better on Windows.
Definition: GlobalFunctions.php:2101
$source
$source
Definition: mwdoc-filter.php:34
wfAssembleUrl
wfAssembleUrl( $urlParts)
This function will reassemble a URL parsed with wfParseURL.
Definition: GlobalFunctions.php:587
$ext
if(!is_readable( $file)) $ext
Definition: router.php:48
wfRelativePath
wfRelativePath( $path, $from)
Generate a relative path name to the given file.
Definition: GlobalFunctions.php:2414
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.
Definition: GlobalFunctions.php:1065
Title\legalChars
static legalChars()
Get a regex character class describing the legal characters in a link.
Definition: Title.php:692
$wgRequest
if(! $wgDBerrorLogTZ) $wgRequest
Definition: Setup.php:729
MediaWiki\Linker\LinkTarget
Definition: LinkTarget.php:26
MWDebug\warning
static warning( $msg, $callerOffset=1, $level=E_USER_NOTICE, $log='auto')
Adds a warning entry to the log.
Definition: MWDebug.php:175
wfMemcKey
wfMemcKey(... $args)
Make a cache key for the local wiki.
Definition: GlobalFunctions.php:2501
Language\fetchLanguageNames
static fetchLanguageNames( $inLanguage=self::AS_AUTONYMS, $include='mw')
Get an array of language names, indexed by code.
Definition: Language.php:854
$wgOut
$wgOut
Definition: Setup.php:863
wfGetServerUrl
wfGetServerUrl( $proto)
Get the wiki's "server", i.e.
Definition: GlobalFunctions.php:569
wfIsHHVM
wfIsHHVM()
Check if we are running under HHVM.
Definition: GlobalFunctions.php:1923
$wgScriptPath
$wgScriptPath
The path we should point to.
Definition: DefaultSettings.php:137
$IP
$IP
Definition: WebStart.php:41
wfLocalFile
wfLocalFile( $title)
Get an object referring to a locally registered file.
Definition: GlobalFunctions.php:2620
Hooks\run
static run( $event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:200
wfShowingResults
wfShowingResults( $offset, $limit)
Definition: GlobalFunctions.php:1502
wfGetCaller
wfGetCaller( $level=2)
Get the name of the function which called this function wfGetCaller( 1 ) is the function with the wfG...
Definition: GlobalFunctions.php:1453
$wgStyleDirectory
$wgStyleDirectory
Filesystem stylesheets directory.
Definition: DefaultSettings.php:236
wfLogDBError
wfLogDBError( $text, array $context=[])
Log for database errors.
Definition: GlobalFunctions.php:1025
SiteStats\edits
static edits()
Definition: SiteStats.php:94
$wgInternalServer
$wgInternalServer
Internal server name as known to CDN, if different.
Definition: DefaultSettings.php:2763
wfExpandUrl
wfExpandUrl( $url, $defaultProto=PROTO_CURRENT)
Expand a potentially local URL to a fully-qualified URL.
Definition: GlobalFunctions.php:491
wfShellExecWithStderr
wfShellExecWithStderr( $cmd, &$retval=null, $environ=[], $limits=[])
Execute a shell command, returning both stdout and stderr.
Definition: GlobalFunctions.php:2182
MediaWiki\HeaderCallback\warnIfHeadersSent
static warnIfHeadersSent()
Log a warning message if headers have already been sent.
Definition: HeaderCallback.php:70
wfLogProfilingData
wfLogProfilingData()
Definition: GlobalFunctions.php:1086
Diff
Class representing a 'diff' between two sequences of strings.
Definition: Diff.php:32
wfShellExec
wfShellExec( $cmd, &$retval=null, $environ=[], $limits=[], $options=[])
Execute a shell command, with time and memory limits mirrored from the PHP configuration if supported...
Definition: GlobalFunctions.php:2129
wfArrayToCgi
wfArrayToCgi( $array1, $array2=null, $prefix='')
This function takes one or two arrays as input, and returns a CGI-style string, e....
Definition: GlobalFunctions.php:347
wfRandomString
wfRandomString( $length=32)
Get a random string containing a number of pseudo-random hex characters.
Definition: GlobalFunctions.php:274
$type
$type
Definition: testCompression.php:50