Movatterモバイル変換

42functionwfLoadExtension( $ext,$path =null ) {

43if ( !$path ) {

44 global$wgExtensionDirectory;

45$path ="$wgExtensionDirectory/$ext/extension.json";

46 }

47 ExtensionRegistry::getInstance()->queue($path );

48}

63functionwfLoadExtensions( array $exts ) {

64 global$wgExtensionDirectory;

65 $registry = ExtensionRegistry::getInstance();

66foreach ( $exts as $ext ) {

67 $registry->queue("$wgExtensionDirectory/$ext/extension.json" );

68 }

69}

79functionwfLoadSkin( $skin,$path =null ) {

80if ( !$path ) {

81 global$wgStyleDirectory;

82$path ="$wgStyleDirectory/$skin/skin.json";

83 }

84 ExtensionRegistry::getInstance()->queue($path );

85}

94functionwfLoadSkins( array $skins ) {

95 global$wgStyleDirectory;

96 $registry = ExtensionRegistry::getInstance();

97foreach ( $skins as $skin ) {

98 $registry->queue("$wgStyleDirectory/$skin/skin.json" );

99 }

100}

109functionwfArrayDiff2( $arr1, $arr2 ) {

110wfDeprecated( __FUNCTION__,'1.43' );

115 $comparator =staticfunction ( $a, $b ):int {

116if ( is_string( $a ) && is_string( $b ) ) {

117return strcmp( $a, $b );

118 }

119if ( !is_array( $a ) && !is_array( $b ) ) {

120thrownew InvalidArgumentException(

122 );

123 }

124if ( count( $a ) !== count( $b ) ) {

125return count( $a ) <=> count( $b );

126 }else {

127 reset( $a );

128 reset( $b );

129while ( key( $a ) !==null && key( $b ) !==null ) {

130 $valueA = current( $a );

131 $valueB = current( $b );

132 $cmp = strcmp( $valueA, $valueB );

133if ( $cmp !== 0 ) {

134return $cmp;

135 }

136 next( $a );

137 next( $b );

138 }

139return 0;

140 }

141 };

142return array_udiff( $arr1, $arr2, $comparator );

143}

165functionwfMergeErrorArrays( ...$args ) {

166wfDeprecated( __FUNCTION__,'1.43' );

167 $out = [];

168foreach ( $args as $errors ) {

169foreach ( $errors as $params ) {

170 $originalParams = $params;

171if ( $params[0] instanceofMessageSpecifier ) {

172 $params = [ $params[0]->getKey(), ...$params[0]->getParams() ];

173 }

176 $spec = implode("\t", $params );

177 $out[$spec] = $originalParams;

178 }

179 }

180return array_values( $out );

181}

192functionwfArrayInsertAfter( array $array, array $insert, $after ) {

194 $keys = array_keys( $array );

195 $offsetByKey = array_flip( $keys );

197if ( !\array_key_exists( $after, $offsetByKey ) ) {

198return $array;

199 }

200 $offset = $offsetByKey[$after];

203 $before = array_slice( $array, 0, $offset + 1,true );

204 $after = array_slice( $array, $offset + 1, count( $array ) - $offset,true );

206 $output = $before + $insert + $after;

208return $output;

209}

219functionwfObjectToArray( $objOrArray, $recursive =true ) {

220 $array = [];

221if ( is_object( $objOrArray ) ) {

222 $objOrArray = get_object_vars( $objOrArray );

223 }

224foreach ( $objOrArray as $key => $value ) {

225if ( $recursive && ( is_object( $value ) || is_array( $value ) ) ) {

226 $value =wfObjectToArray( $value );

227 }

229 $array[$key] = $value;

230 }

232return $array;

233}

245functionwfRandom() {

248 $max = mt_getrandmax() + 1;

249 $rand = number_format( ( mt_rand() * $max + mt_rand() ) / $max / $max, 12,'.','' );

250return $rand;

251}

263functionwfRandomString( $length = 32 ) {

264 $str ='';

265for ( $n = 0; $n < $length; $n += 7 ) {

266 $str .= sprintf('%07x', mt_rand() & 0xfffffff );

267 }

268return substr( $str, 0, $length );

269}

298functionwfUrlencode( $s ) {

299static $needle;

301if ( $s ===null ) {

303 $needle =null;

304return'';

305 }

307if ( $needle ===null ) {

308 $needle = ['%3B','%40','%24','%21','%2A','%28','%29','%2C','%2F','%7E' ];

309if ( !isset( $_SERVER['SERVER_SOFTWARE'] ) ||

310 !str_contains( $_SERVER['SERVER_SOFTWARE'],'Microsoft-IIS/7' )

311 ) {

312 $needle[] ='%3A';

313 }

314 }

316 $s = urlencode( $s );

317 $s = str_ireplace(

318 $needle,

319 [';','@','$','!','*','(',')',',','/','~',':' ],

320 $s

321 );

323return $s;

324}

336functionwfArrayToCgi( $array1, $array2 =null, $prefix ='' ) {

337if ( $array2 !==null ) {

338 $array1 += $array2;

339 }

341 $cgi ='';

342foreach ( $array1 as $key => $value ) {

343if ( $value !==null && $value !==false ) {

344if ( $cgi !='' ) {

345 $cgi .='&';

346 }

347if ( $prefix !=='' ) {

348 $key = $prefix ."[$key]";

349 }

350if ( is_array( $value ) ) {

351 $firstTime =true;

352foreach ( $value as $k => $v ) {

353 $cgi .= $firstTime ?'' :'&';

354if ( is_array( $v ) ) {

355 $cgi .=wfArrayToCgi( $v,null, $key ."[$k]" );

356 }else {

357 $cgi .= urlencode( $key ."[$k]" ) .'=' . urlencode( $v );

358 }

359 $firstTime =false;

360 }

361 }else {

362if ( is_object( $value ) ) {

363 $value = $value->__toString();

364 }

365 $cgi .= urlencode( $key ) .'=' . urlencode( $value );

366 }

367 }

368 }

369return $cgi;

370}

381functionwfCgiToArray( $query ) {

382if ( isset( $query[0] ) && $query[0] =='?' ) {

383 $query = substr( $query, 1 );

384 }

385 $bits = explode('&', $query );

386 $ret = [];

387foreach ( $bits as $bit ) {

388if ( $bit ==='' ) {

389continue;

390 }

391if ( !str_contains( $bit,'=' ) ) {

393 $key = $bit;

394 $value ='';

395 }else {

396 [ $key, $value ] = explode('=', $bit );

397 }

398 $key = urldecode( $key );

399 $value = urldecode( $value );

400if ( str_contains( $key,'[' ) ) {

401 $keys = array_reverse( explode('[', $key ) );

402 $key = array_pop( $keys );

403 $temp = $value;

404foreach ( $keys as $k ) {

405 $k = substr( $k, 0, -1 );

406 $temp = [ $k => $temp ];

407 }

408if ( isset( $ret[$key] ) && is_array( $ret[$key] ) ) {

409 $ret[$key] = array_merge( $ret[$key], $temp );

410 }else {

411 $ret[$key] = $temp;

412 }

413 }else {

414 $ret[$key] = $value;

415 }

416 }

417return $ret;

418}

428functionwfAppendQuery($url, $query ) {

429if ( is_array( $query ) ) {

430 $query =wfArrayToCgi( $query );

431 }

432if ( $query !='' ) {

434 $fragment =false;

435 $hashPos = strpos($url,'#' );

436if ( $hashPos !==false ) {

437 $fragment = substr($url, $hashPos );

438$url = substr($url, 0, $hashPos );

439 }

442if ( !str_contains($url,'?' ) ) {

443$url .='?';

444 }else {

445$url .='&';

446 }

447$url .= $query;

450if ( $fragment !==false ) {

451$url .= $fragment;

452 }

453 }

454return$url;

455}

462functionwfGetUrlUtils():UrlUtils {

463 global$wgServer,$wgCanonicalServer,$wgInternalServer,$wgRequest,$wgHttpsPort,

464$wgUrlProtocols;

466if ( MediaWikiServices::hasInstance() ) {

467 $services = MediaWikiServices::getInstance();

468if ( $services->hasService('UrlUtils' ) ) {

469return $services->getUrlUtils();

470 }

471 }

473returnnewUrlUtils( [

477 UrlUtils::SERVER =>$wgServer ??'',

478 UrlUtils::CANONICAL_SERVER =>$wgCanonicalServer ??'',

479 UrlUtils::INTERNAL_SERVER =>$wgInternalServer ??'',

480 UrlUtils::FALLBACK_PROTOCOL =>$wgRequest ?$wgRequest->getProtocol()

481 :WebRequest::detectProtocol(),

482UrlUtils::HTTPS_PORT =>$wgHttpsPort,

483UrlUtils::VALID_PROTOCOLS =>$wgUrlProtocols,

484 ] );

485}

514functionwfExpandUrl($url, $defaultProto =PROTO_CURRENT ) {

515wfDeprecated( __FUNCTION__,'1.39' );

517returnwfGetUrlUtils()->expand( (string)$url, $defaultProto ) ??false;

518}

532functionwfAssembleUrl( $urlParts ) {

533wfDeprecated( __FUNCTION__,'1.39' );

535return UrlUtils::assemble( (array)$urlParts );

536}

546functionwfUrlProtocols( $includeProtocolRelative =true ) {

547wfDeprecated( __FUNCTION__,'1.39' );

549return $includeProtocolRelative ?wfGetUrlUtils()->validProtocols() :

550wfGetUrlUtils()->validAbsoluteProtocols();

551}

560functionwfUrlProtocolsWithoutProtRel() {

561wfDeprecated( __FUNCTION__,'1.39' );

563returnwfGetUrlUtils()->validAbsoluteProtocols();

564}

592functionwfParseUrl($url ) {

593wfDeprecated( __FUNCTION__,'1.39' );

595returnwfGetUrlUtils()->parse( (string)$url ) ??false;

596}

606functionwfMatchesDomainList($url, $domains ) {

607wfDeprecated( __FUNCTION__,'1.39' );

609returnwfGetUrlUtils()->matchesDomainList( (string)$url, (array)$domains );

610}

632functionwfDebug( $text, $dest ='all', array $context = [] ) {

633 global$wgDebugRawPage,$wgDebugLogPrefix;

635if ( !$wgDebugRawPage &&wfIsDebugRawPage() ) {

636return;

637 }

639 $text = trim( $text );

641if ($wgDebugLogPrefix !=='' ) {

642 $context['prefix'] =$wgDebugLogPrefix;

643 }

644 $context['private'] = ( $dest ===false || $dest ==='private' );

646 $logger = LoggerFactory::getInstance('wfDebug' );

647 $logger->debug( $text, $context );

648}

654functionwfIsDebugRawPage() {

655static $cache;

656if ( $cache !==null ) {

657return $cache;

658 }

661if ( ( isset( $_GET['action'] ) && $_GET['action'] =='raw' )

662 ||MW_ENTRY_POINT ==='load'

663 ) {

664 $cache =true;

665 }else {

666 $cache =false;

667 }

668return $cache;

669}

696functionwfDebugLog(

697 $logGroup, $text, $dest ='all', array $context = []

698) {

699 $text = trim( $text );

701 $logger = LoggerFactory::getInstance( $logGroup );

702 $context['private'] = ( $dest ===false || $dest ==='private' );

703 $logger->info( $text, $context );

704}

714functionwfLogDBError( $text, array $context = [] ) {

715 $logger = LoggerFactory::getInstance('wfLogDBError' );

716 $logger->error( trim( $text ), $context );

717}

735functionwfDeprecated( $function, $version =false, $component =false, $callerOffset = 2 ) {

736if ( !is_string( $version ) && $version !==false ) {

737thrownew InvalidArgumentException(

738"MediaWiki version must either be a string or false. " .

740 );

741 }

743 MWDebug::deprecated( $function, $version, $component, $callerOffset + 1 );

744}

766functionwfDeprecatedMsg( $msg, $version =false, $component =false, $callerOffset = 2 ) {

767 MWDebug::deprecatedMsg( $msg, $version, $component,

768 $callerOffset ===false ?false : $callerOffset + 1 );

769}

781functionwfWarn( $msg, $callerOffset = 1, $level = E_USER_NOTICE ) {

782 MWDebug::warning( $msg, $callerOffset + 1, $level,'auto' );

783}

794functionwfLogWarning( $msg, $callerOffset = 1, $level = E_USER_WARNING ) {

795 MWDebug::warning( $msg, $callerOffset + 1, $level,'production' );

796}

820functionwfMessage( $key, ...$params ) {

821if ( is_array( $key ) ) {

823 $message =wfMessageFallback( ...$key );

824 }else {

825 $message = Message::newFromSpecifier( $key );

826 }

829if ( $params ) {

830 $message->params( ...$params );

831 }

833return $message;

834}

848functionwfMessageFallback( ...$keys ) {

849return Message::newFallbackSequence( ...$keys );

850}

860functionwfMsgReplaceArgs( $message, $args ) {

863 $message = str_replace("\r",'', $message );

866if ( is_array( $args ) && $args ) {

867if ( is_array( $args[0] ) ) {

868 $args = array_values( $args[0] );

869 }

870 $replacementKeys = [];

871foreach ( $args as $n => $param ) {

872 $replacementKeys['$' . ( $n + 1 )] = $param;

873 }

874 $message = strtr( $message, $replacementKeys );

875 }

877return $message;

878}

888functionwfHostname() {

890 global$wgOverrideHostname;

891if ($wgOverrideHostname !==false ) {

892return$wgOverrideHostname;

893 }

895return php_uname('n' ) ?:'unknown';

896}

908functionwfDebugBacktrace( $limit = 0 ) {

909static $disabled =null;

911if ( $disabled ===null ) {

912 $disabled = !function_exists('debug_backtrace' );

913if ( $disabled ) {

914wfDebug("debug_backtrace() is disabled" );

915 }

916 }

917if ( $disabled ) {

918return [];

919 }

921if ( $limit ) {

922return array_slice( debug_backtrace( DEBUG_BACKTRACE_PROVIDE_OBJECT, $limit + 1 ), 1 );

923 }else {

924return array_slice( debug_backtrace(), 1 );

925 }

926}

936functionwfBacktrace( $raw =null ) {

937 $raw ??=MW_ENTRY_POINT ==='cli';

938if ( $raw ) {

939 $frameFormat ="%s line %s calls %s()\n";

940 $traceFormat ="%s";

941 }else {

942 $frameFormat ="<li>%s line %s calls %s()</li>\n";

943 $traceFormat ="<ul>\n%s</ul>\n";

944 }

946 $frames = array_map(staticfunction ( $frame ) use ( $frameFormat ) {

947 $file = !empty( $frame['file'] ) ? basename( $frame['file'] ) :'-';

948 $line = $frame['line'] ??'-';

949 $call = $frame['function'];

950if ( !empty( $frame['class'] ) ) {

951 $call = $frame['class'] . $frame['type'] . $call;

952 }

953return sprintf( $frameFormat, $file, $line, $call );

954 },wfDebugBacktrace() );

956return sprintf( $traceFormat, implode('', $frames ) );

957}

969functionwfGetCaller( $level = 2 ) {

970 $backtrace =wfDebugBacktrace( $level + 1 );

971if ( isset( $backtrace[$level] ) ) {

972returnwfFormatStackFrame( $backtrace[$level] );

973 }else {

974return'unknown';

975 }

976}

985functionwfGetAllCallers( $limit = 3 ) {

986 $trace = array_reverse(wfDebugBacktrace() );

987if ( !$limit || $limit > count( $trace ) - 1 ) {

988 $limit = count( $trace ) - 1;

989 }

990 $trace = array_slice( $trace, -$limit - 1, $limit );

993return implode('/', array_map('wfFormatStackFrame', $trace ) );

994}

1008functionwfFormatStackFrame( $frame ) {

1009if ( !isset( $frame['function'] ) ) {

1010return'NO_FUNCTION_GIVEN';

1011 }

1012return isset( $frame['class'] ) && isset( $frame['type'] ) ?

1013 $frame['class'] . $frame['type'] . $frame['function'] :

1014 $frame['function'];

1015}

1026functionwfClientAcceptsGzip( $force =false ) {

1027static $result =null;

1028if ( $result ===null || $force ) {

1029 $result =false;

1030if ( isset( $_SERVER['HTTP_ACCEPT_ENCODING'] ) ) {

1032 $m = [];

1033if ( preg_match(

1034'/\bgzip(?:;(q)=([0-9]+(?:\.[0-9]+)))?\b/',

1035 $_SERVER['HTTP_ACCEPT_ENCODING'],

1036 $m

1037 )

1038 ) {

1039if ( isset( $m[2] ) && ( $m[1] =='q' ) && ( $m[2] == 0 ) ) {

1040return $result;

1041 }

1042wfDebug("wfClientAcceptsGzip: client accepts gzip." );

1043 $result =true;

1044 }

1045 }

1046 }

1047return $result;

1048}

1060functionwfEscapeWikiText( $input ): string {

1061 global$wgEnableMagicLinks;

1062static $repl =null, $repl2 =null, $repl3 =null, $repl4 =null;

1063if ( $repl ===null || defined('MW_PHPUNIT_TEST' ) ) {

1066 $repl = [

1067'"' =>'&#34;','&' =>'&#38;',"'" =>'&#39;','<' =>'&#60;',

1068'=' =>'&#61;','>' =>'&#62;','[' =>'&#91;',']' =>'&#93;',

1069'{' =>'&#123;','|' =>'&#124;','}' =>'&#125;',

1070';' =>'&#59;',// a token inside language converter brackets

1071'!!' =>'&#33;!',// a token inside table context

1072"\n!" =>"\n&#33;","\r!" =>"\r&#33;",// a token inside table context

1073"\n#" =>"\n&#35;","\r#" =>"\r&#35;",

1074"\n*" =>"\n&#42;","\r*" =>"\r&#42;",

1075"\n:" =>"\n&#58;","\r:" =>"\r&#58;",

1076"\n " =>"\n&#32;","\r " =>"\r&#32;",

1077"\n\n" =>"\n&#10;","\r\n" =>"&#13;\n",

1078"\n\r" =>"\n&#13;","\r\r" =>"\r&#13;",

1079"\n\t" =>"\n&#9;","\r\t" =>"\r&#9;",// "\n\t\n" is treated like "\n\n"

1080"\n----" =>"\n&#45;---","\r----" =>"\r&#45;---",

1081'__' =>'_&#95;','://' =>'&#58;//',

1083'＿' =>'&#xFF3F;',

1084'~~~' =>'~~&#126;',// protect from PST, just to be safe(r)

1085 ];

1087 $magicLinks = array_keys( array_filter($wgEnableMagicLinks ) );

1089foreach ( $magicLinks as $magic ) {

1090 $repl["$magic "] ="$magic&#32;";

1091 $repl["$magic\t"] ="$magic&#9;";

1092 $repl["$magic\r"] ="$magic&#13;";

1093 $repl["$magic\n"] ="$magic&#10;";

1094 $repl["$magic\f"] ="$magic&#12;";

1095 }

1103 $repl3 = [

1104'+' =>'&#43;','-' =>'&#45;','_' =>'&#95;','~' =>'&#126;',

1105 ];

1112 $repl4 = [

1113'_' =>'&#95;','~' =>'&#126;',

1114"\n" =>"&#10;","\r" =>"&#13;",

1115"\t" =>"&#9;",// "\n\t\n" is treated like "\n\n"

1116 ];

1119 global$wgUrlProtocols;

1120 $repl2 = [];

1121foreach ($wgUrlProtocols as $prot ) {

1122if ( substr( $prot, -1 ) ===':' ) {

1123 $repl2[] = preg_quote( substr( $prot, 0, -1 ),'/' );

1124 }

1125 }

1126 $repl2 = $repl2 ?'/\b(' . implode('|', $repl2 ) .'):/i' :'/^(?!)/';

1127 }

1129'@phan-var string $repl2';

1130'@phan-var string $repl3';

1131'@phan-var string $repl4';

1133 $text = substr( strtr("\n$input", $repl ), 1 );

1134if ( $text ==='' ) {

1135return $text;

1136 }

1137 $first = strtr( $text[0], $repl3 );// protect first character

1138if ( strlen( $text ) > 1 ) {

1139 $text = $first . substr( $text, 1, -1 ) .

1140 strtr( substr( $text, -1 ), $repl4 );// protect last character

1141 }else {

1143 $text = strtr( $first, $repl4 );// protect last character

1144 }

1145 $text = preg_replace( $repl2,'$1&#58;', $text );

1146return $text;

1147}

1159functionwfSetVar( &$dest,$source, $force =false ) {

1160 $temp = $dest;

1161if ($source !==null || $force ) {

1162 $dest =$source;

1163 }

1164return $temp;

1165}

1176functionwfSetBit( &$dest, $bit, $state =true ) {

1177 $temp = (bool)( $dest & $bit );

1178if ( $state !==null ) {

1179if ( $state ) {

1180 $dest |= $bit;

1181 }else {

1182 $dest &= ~$bit;

1183 }

1184 }

1185return $temp;

1186}

1194functionwfVarDump( $var ) {

1195 global$wgOut;

1196 $s = str_replace("\n","<br />\n", var_export( $var,true ) ."\n" );

1197if ( headers_sent() ||$wgOut ===null || !is_object($wgOut ) ) {

1198 print $s;

1199 }else {

1200$wgOut->addHTML( $s );

1201 }

1202}

1211functionwfHttpError( $code, $label, $desc ) {

1212 global$wgOut;

1213 HttpStatus::header( $code );

1214if ($wgOut ) {

1215$wgOut->disable();

1216$wgOut->sendCacheControl();

1217 }

1219 \MediaWiki\Request\HeaderCallback::warnIfHeadersSent();

1220 header('Content-type: text/html; charset=utf-8' );

1221 ContentSecurityPolicy::sendRestrictiveHeader();

1222 ob_start();

1223 print'<!DOCTYPE html>' .

1224'<html><head><title>' .

1225 htmlspecialchars( $label ) .

1226'</title><meta name="color-scheme" content="light dark" /></head><body><h1>' .

1227 htmlspecialchars( $label ) .

1228'</h1><p>' .

1229 nl2br( htmlspecialchars( $desc ) ) .

1230"</p></body></html>\n";

1231 header('Content-Length: ' . ob_get_length() );

1232 ob_end_flush();

1233}

1255functionwfResetOutputBuffers( $resetGzipEncoding =true ) {

1257while ( $status = ob_get_status() ) {

1258if ( isset( $status['flags'] ) ) {

1259 $flags = PHP_OUTPUT_HANDLER_CLEANABLE | PHP_OUTPUT_HANDLER_REMOVABLE;

1260 $deleteable = ( $status['flags'] & $flags ) === $flags;

1261 } elseif ( isset( $status['del'] ) ) {

1262 $deleteable = $status['del'];

1263 }else {

1265 $deleteable = $status['type'] !== 0;/* PHP_OUTPUT_HANDLER_INTERNAL */

1266 }

1267if ( !$deleteable ) {

1270break;

1271 }

1272if ( $status['name'] ==='MediaWikiIntegrationTestCase::wfResetOutputBuffersBarrier' ) {

1274break;

1275 }

1276if ( !ob_end_clean() ) {

1279break;

1280 }

1281if ( $resetGzipEncoding && $status['name'] =='ob_gzhandler' ) {

1284 header_remove('Content-Encoding' );

1285break;

1286 }

1287 }

1288}

1300functionwfTimestamp( $outputtype = TS_UNIX, $ts = 0 ) {

1301 $ret = ConvertibleTimestamp::convert( $outputtype, $ts );

1302if ( $ret ===false ) {

1303wfDebug("wfTimestamp() fed bogus time value: TYPE=$outputtype; VALUE=$ts" );

1304 }

1305return $ret;

1306}

1316functionwfTimestampOrNull( $outputtype = TS_UNIX, $ts =null ) {

1317if ( $ts ===null ) {

1318returnnull;

1319 }else {

1320returnwfTimestamp( $outputtype, $ts );

1321 }

1322}

1329functionwfTimestampNow() {

1330return ConvertibleTimestamp::now( TS_MW );

1331}

1344functionwfTempDir() {

1345 global$wgTmpDirectory;

1347if ($wgTmpDirectory !==false ) {

1348return$wgTmpDirectory;

1349 }

1351return TempFSFile::getUsableTempDirectory();

1352}

1362functionwfMkdirParents( $dir, $mode =null, $caller =null ) {

1363 global$wgDirectoryMode;

1365if ( FileBackend::isStoragePath( $dir ) ) {

1366thrownew LogicException( __FUNCTION__ ." given storage path '$dir'." );

1367 }

1368if ( $caller !==null ) {

1369wfDebug("$caller: called wfMkdirParents($dir)" );

1370 }

1371if ( strval( $dir ) ==='' ) {

1372returntrue;

1373 }

1375 $dir = str_replace( ['\\','/' ], DIRECTORY_SEPARATOR, $dir );

1376 $mode ??=$wgDirectoryMode;

1385 $ok = is_dir( $dir ) || @mkdir( $dir, $mode,true ) || is_dir( $dir );

1386if ( !$ok ) {

1387 trigger_error( sprintf("failed to mkdir \"%s\" mode 0%o", $dir, $mode ), E_USER_WARNING );

1388 }

1390return $ok;

1391}

1398functionwfRecursiveRemoveDir( $dir ) {

1400if ( is_dir( $dir ) ) {

1401 $objects = scandir( $dir );

1402foreach ( $objects as $object ) {

1403if ( $object !="." && $object !=".." ) {

1404if ( filetype( $dir .'/' . $object ) =="dir" ) {

1405wfRecursiveRemoveDir( $dir .'/' . $object );

1406 }else {

1407 unlink( $dir .'/' . $object );

1408 }

1409 }

1410 }

1411 rmdir( $dir );

1412 }

1413}

1421functionwfPercent( $nr,int $acc = 2,bool $round =true ) {

1422 $accForFormat = $acc >= 0 ? $acc : 0;

1423 $ret = sprintf("%.{$accForFormat}f", $nr );

1424return $round ? round( (float)$ret, $acc ) .'%' :"$ret%";

1425}

1450functionwfIniGetBool( $setting ) {

1451returnwfStringToBool( ini_get( $setting ) );

1452}

1466functionwfStringToBool( $val ) {

1467 $val = strtolower( $val );

1469return $val =='on'

1470 || $val =='true'

1471 || $val =='yes'

1472 || preg_match("/^\s*[+-]?0*[1-9]/", $val );// approx C atoi() function

1473}

1488functionwfEscapeShellArg( ...$args ) {

1489return Shell::escape( ...$args );

1490}

1516functionwfShellExec( $cmd, &$retval =null, $environ = [],

1517 $limits = [], $options = []

1518) {

1519if ( Shell::isDisabled() ) {

1520 $retval = 1;

1522return'Unable to run external programs, proc_open() is disabled.';

1523 }

1525if ( is_array( $cmd ) ) {

1526 $cmd = Shell::escape( $cmd );

1527 }

1529 $includeStderr = isset( $options['duplicateStderr'] ) && $options['duplicateStderr'];

1530 $profileMethod = $options['profileMethod'] ??wfGetCaller();

1532try {

1533 $result = Shell::command( [] )

1534 ->unsafeParams( (array)$cmd )

1535 ->environment( $environ )

1536 ->limits( $limits )

1537 ->includeStderr( $includeStderr )

1538 ->profileMethod( $profileMethod )

1540 ->restrict( Shell::RESTRICT_NONE )

1541 ->execute();

1542 }catch (ProcOpenError ) {

1543 $retval = -1;

1544return'';

1545 }

1547 $retval = $result->getExitCode();

1549return $result->getStdout();

1550}

1569functionwfShellExecWithStderr( $cmd, &$retval =null, $environ = [], $limits = [] ) {

1570returnwfShellExec( $cmd, $retval, $environ, $limits,

1571 ['duplicateStderr' =>true,'profileMethod' =>wfGetCaller() ] );

1572}

1589functionwfShellWikiCmd( $script, array $parameters = [], array $options = [] ) {

1590 global$wgPhpCli;

1593 (newHookRunner( MediaWikiServices::getInstance()->getHookContainer() ) )

1594 ->onWfShellWikiCmd( $script, $parameters, $options );

1595 $cmd = [ $options['php'] ??$wgPhpCli ];

1596if ( isset( $options['wrapper'] ) ) {

1597 $cmd[] = $options['wrapper'];

1598 }

1599 $cmd[] = $script;

1601return Shell::escape( array_merge( $cmd, $parameters ) );

1602}

1620functionwfMerge(

1621string $old,

1622string $mine,

1623string $yours,

1624 ?string &$simplisticMergeAttempt,

1625 ?string &$mergeLeftovers =null

1626): bool {

1627 global$wgDiff3;

1631 AtEase::suppressWarnings();

1632 $haveDiff3 =$wgDiff3 && file_exists($wgDiff3 );

1633 AtEase::restoreWarnings();

1635if ( !$haveDiff3 ) {

1636wfDebug("diff3 not found" );

1637returnfalse;

1638 }

1641 $td =wfTempDir();

1642 $oldtextFile = fopen( $oldtextName = tempnam( $td,'merge-old-' ),'w' );

1643 $mytextFile = fopen( $mytextName = tempnam( $td,'merge-mine-' ),'w' );

1644 $yourtextFile = fopen( $yourtextName = tempnam( $td,'merge-your-' ),'w' );

1650 fwrite( $oldtextFile, rtrim( $old ) ."\n" );

1651 fclose( $oldtextFile );

1652 fwrite( $mytextFile, rtrim( $mine ) ."\n" );

1653 fclose( $mytextFile );

1654 fwrite( $yourtextFile, rtrim( $yours ) ."\n" );

1655 fclose( $yourtextFile );

1658 $cmd = Shell::escape($wgDiff3,'--text','--overlap-only', $mytextName,

1659 $oldtextName, $yourtextName );

1660 $handle = popen( $cmd,'r' );

1662 $mergeLeftovers ='';

1663do {

1664 $data = fread( $handle, 8192 );

1665if ( $data ===false || $data ==='' ) {

1666break;

1667 }

1668 $mergeLeftovers .= $data;

1669 }while (true );

1670 pclose( $handle );

1672 $conflict = $mergeLeftovers !=='';

1675 $cmd = Shell::escape($wgDiff3,'--text','--ed','--merge', $mytextName,

1676 $oldtextName, $yourtextName );

1677 $handle = popen( $cmd,'r' );

1678 $simplisticMergeAttempt ='';

1679do {

1680 $data = fread( $handle, 8192 );

1681if ( $data ===false || $data ==='' ) {

1682break;

1683 }

1684 $simplisticMergeAttempt .= $data;

1685 }while (true );

1686 pclose( $handle );

1687 unlink( $mytextName );

1688 unlink( $oldtextName );

1689 unlink( $yourtextName );

1691if ( $simplisticMergeAttempt ==='' && $old !=='' && !$conflict ) {

1692wfDebug("Unexpected null result from diff3. Command: $cmd" );

1693 $conflict =true;

1694 }

1695return !$conflict;

1696}

1710functionwfBaseName($path, $suffix ='' ) {

1711if ( $suffix =='' ) {

1712 $encSuffix ='';

1713 }else {

1714 $encSuffix ='(?:' . preg_quote( $suffix,'#' ) .')?';

1715 }

1717$matches = [];

1718if ( preg_match("#([^/\\\\]*?){$encSuffix}[/\\\\]*$#",$path,$matches ) ) {

1719return$matches[1];

1720 }else {

1721return'';

1722 }

1723}

1734functionwfRelativePath($path, $from ) {

1736$path = str_replace('/', DIRECTORY_SEPARATOR,$path );

1737 $from = str_replace('/', DIRECTORY_SEPARATOR, $from );

1740$path = rtrim($path, DIRECTORY_SEPARATOR );

1741 $from = rtrim( $from, DIRECTORY_SEPARATOR );

1743 $pieces = explode( DIRECTORY_SEPARATOR, dirname($path ) );

1744 $against = explode( DIRECTORY_SEPARATOR, $from );

1746if ( $pieces[0] !== $against[0] ) {

1749return$path;

1750 }

1753while ( count( $pieces ) && count( $against )

1754 && $pieces[0] == $against[0] ) {

1755 array_shift( $pieces );

1756 array_shift( $against );

1757 }

1760while ( count( $against ) ) {

1761 array_unshift( $pieces,'..' );

1762 array_shift( $against );

1763 }

1765 $pieces[] =wfBaseName($path );

1767return implode( DIRECTORY_SEPARATOR, $pieces );

1768}

1779functionwfScript( $script ='index' ) {

1780 global$wgScriptPath,$wgScript,$wgLoadScript;

1781if ( $script ==='index' ) {

1782return$wgScript;

1783 } elseif ( $script ==='load' ) {

1784return$wgLoadScript;

1785 }else {

1786return"{$wgScriptPath}/{$script}.php";

1787 }

1788}

1797functionwfBoolToStr( $value ) {

1798return $value ?'true' :'false';

1799}

1806functionwfGetNull() {

1807returnwfIsWindows() ?'NUL' :'/dev/null';

1808}

1818functionwfStripIllegalFilenameChars( $name ) {

1819 global$wgIllegalFileChars;

1820 $illegalFileChars =$wgIllegalFileChars ?"|[" .$wgIllegalFileChars ."]" :'';

1821 $name = preg_replace(

1822"/[^" . Title::legalChars() ."]" . $illegalFileChars ."/",

1823'-',

1824 $name

1825 );

1827 $name =wfBaseName( $name );

1828return $name;

1829}

1837functionwfMemoryLimit( $newLimit ) {

1838 $oldLimit =wfShorthandToInteger( ini_get('memory_limit' ) );

1840if ( $oldLimit != -1 ) {

1841 $newLimit =wfShorthandToInteger( (string)$newLimit );

1842if ( $newLimit == -1 ) {

1843wfDebug("Removing PHP's memory limit" );

1844 AtEase::suppressWarnings();

1845 ini_set('memory_limit', $newLimit );

1846 AtEase::restoreWarnings();

1847 } elseif ( $newLimit > $oldLimit ) {

1848wfDebug("Raising PHP's memory limit to $newLimit bytes" );

1849 AtEase::suppressWarnings();

1850 ini_set('memory_limit', $newLimit );

1851 AtEase::restoreWarnings();

1852 }

1853 }

1854}

1862functionwfTransactionalTimeLimit() {

1863 global$wgTransactionalTimeLimit;

1865 $timeout = RequestTimeout::singleton();

1866 $timeLimit = $timeout->getWallTimeLimit();

1867if ( $timeLimit !== INF ) {

1869if ($wgTransactionalTimeLimit > $timeLimit ) {

1870 $timeout->setWallTimeLimit($wgTransactionalTimeLimit );

1871 }

1872 }else {

1874 $timeLimit = (int)ini_get('max_execution_time' );

1876if ( $timeLimit > 0 &&$wgTransactionalTimeLimit > $timeLimit ) {

1877 $timeout->setWallTimeLimit($wgTransactionalTimeLimit );

1878 }

1879 }

1880 ignore_user_abort(true );// ignore client disconnects

1882return $timeLimit;

1883}

1892functionwfShorthandToInteger( ?string $string ='',int $default = -1 ): int {

1893 $string = trim( $string ??'' );

1894if ( $string ==='' ) {

1895return $default;

1896 }

1897 $last = substr( $string, -1 );

1898 $val = intval( $string );

1899switch ( $last ) {

1900case'g':

1901case'G':

1902 $val *= 1024;

1904case'm':

1905case'M':

1906 $val *= 1024;

1908case'k':

1909case'K':

1910 $val *= 1024;

1911 }

1913return $val;

1914}

1923functionwfIsInfinity( $str ) {

1925return in_array( $str, ExpiryDef::INFINITY_VALS );

1926}

1942functionwfThumbIsStandard(File $file, array $params ) {

1943 global$wgThumbLimits,$wgImageLimits,$wgResponsiveImages;

1945 $multipliers = [ 1 ];

1946if ($wgResponsiveImages ) {

1949 $multipliers[] = 1.5;

1950 $multipliers[] = 2;

1951 }

1953 $handler = $file->getHandler();

1954if ( !$handler || !isset( $params['width'] ) ) {

1955returnfalse;

1956 }

1958 $basicParams = [];

1959if ( isset( $params['page'] ) ) {

1960 $basicParams['page'] = $params['page'];

1961 }

1963 $thumbLimits = [];

1964 $imageLimits = [];

1966foreach ( $multipliers as $multiplier ) {

1967 $thumbLimits = array_merge( $thumbLimits, array_map(

1968staticfunction ( $width ) use ( $multiplier ) {

1969return round( $width * $multiplier );

1970 },$wgThumbLimits )

1971 );

1972 $imageLimits = array_merge( $imageLimits, array_map(

1973staticfunction ( $pair ) use ( $multiplier ) {

1974return [

1975 round( $pair[0] * $multiplier ),

1976 round( $pair[1] * $multiplier ),

1977 ];

1978 },$wgImageLimits )

1979 );

1980 }

1983if ( in_array( $params['width'], $thumbLimits ) ) {

1984 $normalParams = $basicParams + ['width' => $params['width'] ];

1986 $handler->normaliseParams( $file, $normalParams );

1987 }else {

1989 $match =false;

1990foreach ( $imageLimits as $pair ) {

1991 $normalParams = $basicParams + ['width' => $pair[0],'height' => $pair[1] ];

1994 $handler->normaliseParams( $file, $normalParams );

1996if ( $normalParams['width'] == $params['width'] ) {

1997 $match =true;

1998break;

1999 }

2000 }

2001if ( !$match ) {

2002returnfalse;// not standard for description pages

2003 }

2004 }

2007foreach ( $params as $key => $value ) {

2008if ( !isset( $normalParams[$key] ) || $normalParams[$key] != $value ) {

2009returnfalse;

2010 }

2011 }

2013returntrue;

2014}

2028functionwfArrayPlus2d( array $baseArray, array $newValues ) {

2030foreach ( $baseArray as $name => &$groupVal ) {

2031if ( isset( $newValues[$name] ) ) {

2032 $groupVal += $newValues[$name];

2033 }

2034 }

2036 $baseArray += $newValues;

2038return $baseArray;

2039}

wfIsWindows()

Check if the operating system is Windows.

const PROTO_CURRENT

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.

wfEscapeWikiText( $input)

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

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.

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...

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.

wfGetUrlUtils()

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 using $wgServer (or one of its alternatives).

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)

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 partial regular expression of recognized URL protocols, e.g.

wfMessageFallback(... $keys)

This function accepts multiple message keys and returns a message instance for the first message whic...

wfMerge(string $old, string $mine, string $yours, ?string &$simplisticMergeAttempt, ?string &$mergeLeftovers=null)

wfMerge attempts to merge differences between three texts.

wfGetAllCallers( $limit=3)

Return a string consisting of callers in the stack.

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.

wfLoadSkin( $skin, $path=null)

Load a skin.

wfMsgReplaceArgs( $message, $args)

Replace message parameter keys on the given formatted output.

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 URL path to a MediaWiki entry point.

wfCgiToArray( $query)

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

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.

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.

$path

$matches

global $wgRequest

if(MW_ENTRY_POINT==='index') if(!defined( 'MW_NO_SESSION') &&MW_ENTRY_POINT !=='cli' $wgOut

const MW_ENTRY_POINT

Debug toolbar.

Implements some public methods and some protected utility functions which are required by multiple ch...

getHandler()

Get a MediaHandler instance for this file.

This class provides an implementation of the core hook interfaces, forwarding hook calls to HookConta...

Create PSR-3 logger objects.

Service locator for MediaWiki core services.

The Message class deals with fetching and processing of interface message into a variety of formats.

Load JSON files, and uses a Processor to extract information.

Handle sending Content-Security-Policy headers.

The WebRequest class encapsulates getting at data passed in the URL or via a POSTed form,...

Executes shell commands.

Represents a title within MediaWiki.

A service to expand, parse, and otherwise manipulate URLs.

This class is used to hold the location and do limited manipulation of files stored temporarily (this...

Base class for all file backend classes (including multi-write backends).

Value object representing a message parameter that consists of a list of values.

Type definition for expiry timestamps.

$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.

$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.

$source

$url