Merge "docs: Fix Doxygen warning for invalid `@bar` in WANObjectCache"
[lhc/web/wiklou.git] / includes / Setup.php
1 <?php
2 /**
3 * Include most things that are needed to make MediaWiki work.
4 *
5 * This file is included by WebStart.php and doMaintenance.php so that both
6 * web and maintenance scripts share a final set up phase to include necessary
7 * files and create global object variables.
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
22 * http://www.gnu.org/copyleft/gpl.html
23 *
24 * @file
25 */
26 use MediaWiki\MediaWikiServices;
27 use Wikimedia\Rdbms\LBFactory;
28 use Wikimedia\Rdbms\ChronologyProtector;
29
30 /**
31 * This file is not a valid entry point, perform no further processing unless
32 * MEDIAWIKI is defined
33 */
34 if ( !defined( 'MEDIAWIKI' ) ) {
35 exit( 1 );
36 }
37
38 // Check to see if we are at the file scope
39 $wgScopeTest = 'MediaWiki Setup.php scope test';
40 if ( !isset( $GLOBALS['wgScopeTest'] ) || $GLOBALS['wgScopeTest'] !== $wgScopeTest ) {
41 echo "Error, Setup.php must be included from the file scope.\n";
42 die( 1 );
43 }
44 unset( $wgScopeTest );
45
46 /**
47 * Pre-config setup: Before loading LocalSettings.php
48 */
49
50 // Sanity check (T5782, T122807)
51 if ( ini_get( 'mbstring.func_overload' ) ) {
52 die( 'MediaWiki does not support installations where mbstring.func_overload is non-zero.' );
53 }
54
55 // Start the autoloader, so that extensions can derive classes from core files
56 require_once "$IP/includes/AutoLoader.php";
57
58 // Load global constants
59 require_once "$IP/includes/Defines.php";
60
61 // Load default settings
62 require_once "$IP/includes/DefaultSettings.php";
63
64 // Load global functions
65 require_once "$IP/includes/GlobalFunctions.php";
66
67 // Load composer's autoloader if present
68 if ( is_readable( "$IP/vendor/autoload.php" ) ) {
69 require_once "$IP/vendor/autoload.php";
70 } elseif ( file_exists( "$IP/vendor/autoload.php" ) ) {
71 die( "$IP/vendor/autoload.php exists but is not readable" );
72 }
73
74 // Assert that composer dependencies were successfully loaded
75 // Purposely no leading \ due to it breaking HHVM RepoAuthorative mode
76 // PHP works fine with both versions
77 // See https://github.com/facebook/hhvm/issues/5833
78 if ( !interface_exists( 'Psr\Log\LoggerInterface' ) ) {
79 $message = (
80 'MediaWiki requires the <a href="https://github.com/php-fig/log">PSR-3 logging ' .
81 "library</a> to be present. This library is not embedded directly in MediaWiki's " .
82 "git repository and must be installed separately by the end user.\n\n" .
83 'Please see <a href="https://www.mediawiki.org/wiki/Download_from_Git' .
84 '#Fetch_external_libraries">mediawiki.org</a> for help on installing ' .
85 'the required components.'
86 );
87 echo $message;
88 trigger_error( $message, E_USER_ERROR );
89 die( 1 );
90 }
91
92 /**
93 * Changes to the PHP environment that don't vary on configuration.
94 */
95
96 // Install a header callback
97 MediaWiki\HeaderCallback::register();
98
99 // Set the encoding used by PHP for reading HTTP input, and writing output.
100 // This is also the default for mbstring functions.
101 mb_internal_encoding( 'UTF-8' );
102
103 /**
104 * Load LocalSettings.php
105 */
106
107 if ( defined( 'MW_CONFIG_CALLBACK' ) ) {
108 call_user_func( MW_CONFIG_CALLBACK );
109 } else {
110 if ( !defined( 'MW_CONFIG_FILE' ) ) {
111 define( 'MW_CONFIG_FILE', "$IP/LocalSettings.php" );
112 }
113 require_once MW_CONFIG_FILE;
114 }
115
116 /**
117 * Customization point after all loading (constants, functions, classes,
118 * DefaultSettings, LocalSettings). Specifically, this is before usage of
119 * settings, before instantiation of Profiler (and other singletons), and
120 * before any setup functions or hooks run.
121 */
122
123 if ( defined( 'MW_SETUP_CALLBACK' ) ) {
124 call_user_func( MW_SETUP_CALLBACK );
125 }
126
127 /**
128 * Main setup
129 */
130
131 // Load queued extensions
132 ExtensionRegistry::getInstance()->loadFromQueue();
133 // Don't let any other extensions load
134 ExtensionRegistry::getInstance()->finish();
135
136 // Set the configured locale on all requests for consisteny
137 putenv( "LC_ALL=$wgShellLocale" );
138 setlocale( LC_ALL, $wgShellLocale );
139
140 // Set various default paths sensibly...
141 if ( $wgScript === false ) {
142 $wgScript = "$wgScriptPath/index.php";
143 }
144 if ( $wgLoadScript === false ) {
145 $wgLoadScript = "$wgScriptPath/load.php";
146 }
147 if ( $wgRestPath === false ) {
148 $wgRestPath = "$wgScriptPath/rest.php";
149 }
150
151 if ( $wgArticlePath === false ) {
152 if ( $wgUsePathInfo ) {
153 $wgArticlePath = "$wgScript/$1";
154 } else {
155 $wgArticlePath = "$wgScript?title=$1";
156 }
157 }
158
159 if ( !empty( $wgActionPaths ) && !isset( $wgActionPaths['view'] ) ) {
160 // 'view' is assumed the default action path everywhere in the code
161 // but is rarely filled in $wgActionPaths
162 $wgActionPaths['view'] = $wgArticlePath;
163 }
164
165 if ( $wgResourceBasePath === null ) {
166 $wgResourceBasePath = $wgScriptPath;
167 }
168 if ( $wgStylePath === false ) {
169 $wgStylePath = "$wgResourceBasePath/skins";
170 }
171 if ( $wgLocalStylePath === false ) {
172 // Avoid wgResourceBasePath here since that may point to a different domain (e.g. CDN)
173 $wgLocalStylePath = "$wgScriptPath/skins";
174 }
175 if ( $wgExtensionAssetsPath === false ) {
176 $wgExtensionAssetsPath = "$wgResourceBasePath/extensions";
177 }
178
179 if ( $wgLogo === false ) {
180 $wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
181 }
182
183 if ( $wgUploadPath === false ) {
184 $wgUploadPath = "$wgScriptPath/images";
185 }
186 if ( $wgUploadDirectory === false ) {
187 $wgUploadDirectory = "$IP/images";
188 }
189 if ( $wgReadOnlyFile === false ) {
190 $wgReadOnlyFile = "{$wgUploadDirectory}/lock_yBgMBwiR";
191 }
192 if ( $wgFileCacheDirectory === false ) {
193 $wgFileCacheDirectory = "{$wgUploadDirectory}/cache";
194 }
195 if ( $wgDeletedDirectory === false ) {
196 $wgDeletedDirectory = "{$wgUploadDirectory}/deleted";
197 }
198
199 if ( $wgGitInfoCacheDirectory === false && $wgCacheDirectory !== false ) {
200 $wgGitInfoCacheDirectory = "{$wgCacheDirectory}/gitinfo";
201 }
202
203 // Fix path to icon images after they were moved in 1.24
204 if ( $wgRightsIcon ) {
205 $wgRightsIcon = str_replace(
206 "{$wgStylePath}/common/images/",
207 "{$wgResourceBasePath}/resources/assets/licenses/",
208 $wgRightsIcon
209 );
210 }
211
212 if ( isset( $wgFooterIcons['copyright']['copyright'] )
213 && $wgFooterIcons['copyright']['copyright'] === []
214 ) {
215 if ( $wgRightsIcon || $wgRightsText ) {
216 $wgFooterIcons['copyright']['copyright'] = [
217 'url' => $wgRightsUrl,
218 'src' => $wgRightsIcon,
219 'alt' => $wgRightsText,
220 ];
221 }
222 }
223
224 if ( isset( $wgFooterIcons['poweredby'] )
225 && isset( $wgFooterIcons['poweredby']['mediawiki'] )
226 && $wgFooterIcons['poweredby']['mediawiki']['src'] === null
227 ) {
228 $wgFooterIcons['poweredby']['mediawiki']['src'] =
229 "$wgResourceBasePath/resources/assets/poweredby_mediawiki_88x31.png";
230 $wgFooterIcons['poweredby']['mediawiki']['srcset'] =
231 "$wgResourceBasePath/resources/assets/poweredby_mediawiki_132x47.png 1.5x, " .
232 "$wgResourceBasePath/resources/assets/poweredby_mediawiki_176x62.png 2x";
233 }
234
235 /**
236 * Unconditional protection for NS_MEDIAWIKI since otherwise it's too easy for a
237 * sysadmin to set $wgNamespaceProtection incorrectly and leave the wiki insecure.
238 *
239 * Note that this is the definition of editinterface and it can be granted to
240 * all users if desired.
241 */
242 $wgNamespaceProtection[NS_MEDIAWIKI] = 'editinterface';
243
244 /**
245 * The canonical names of namespaces 6 and 7 are, as of v1.14, "File"
246 * and "File_talk". The old names "Image" and "Image_talk" are
247 * retained as aliases for backwards compatibility.
248 */
249 $wgNamespaceAliases['Image'] = NS_FILE;
250 $wgNamespaceAliases['Image_talk'] = NS_FILE_TALK;
251
252 /**
253 * Initialise $wgLockManagers to include basic FS version
254 */
255 $wgLockManagers[] = [
256 'name' => 'fsLockManager',
257 'class' => FSLockManager::class,
258 'lockDirectory' => "{$wgUploadDirectory}/lockdir",
259 ];
260 $wgLockManagers[] = [
261 'name' => 'nullLockManager',
262 'class' => NullLockManager::class,
263 ];
264
265 /**
266 * Default parameters for the "<gallery>" tag.
267 * @see DefaultSettings.php for description of the fields.
268 */
269 $wgGalleryOptions += [
270 'imagesPerRow' => 0,
271 'imageWidth' => 120,
272 'imageHeight' => 120,
273 'captionLength' => true,
274 'showBytes' => true,
275 'showDimensions' => true,
276 'mode' => 'traditional',
277 ];
278
279 /**
280 * Shortcuts for $wgLocalFileRepo
281 */
282 if ( !$wgLocalFileRepo ) {
283 $wgLocalFileRepo = [
284 'class' => LocalRepo::class,
285 'name' => 'local',
286 'directory' => $wgUploadDirectory,
287 'scriptDirUrl' => $wgScriptPath,
288 'url' => $wgUploadBaseUrl ? $wgUploadBaseUrl . $wgUploadPath : $wgUploadPath,
289 'hashLevels' => $wgHashedUploadDirectory ? 2 : 0,
290 'thumbScriptUrl' => $wgThumbnailScriptPath,
291 'transformVia404' => !$wgGenerateThumbnailOnParse,
292 'deletedDir' => $wgDeletedDirectory,
293 'deletedHashLevels' => $wgHashedUploadDirectory ? 3 : 0
294 ];
295 }
296
297 if ( !isset( $wgLocalFileRepo['backend'] ) ) {
298 // Create a default FileBackend name.
299 // FileBackendGroup will register a default, if absent from $wgFileBackends.
300 $wgLocalFileRepo['backend'] = $wgLocalFileRepo['name'] . '-backend';
301 }
302
303 /**
304 * Shortcuts for $wgForeignFileRepos
305 */
306 if ( $wgUseSharedUploads ) {
307 if ( $wgSharedUploadDBname ) {
308 $wgForeignFileRepos[] = [
309 'class' => ForeignDBRepo::class,
310 'name' => 'shared',
311 'directory' => $wgSharedUploadDirectory,
312 'url' => $wgSharedUploadPath,
313 'hashLevels' => $wgHashedSharedUploadDirectory ? 2 : 0,
314 'thumbScriptUrl' => $wgSharedThumbnailScriptPath,
315 'transformVia404' => !$wgGenerateThumbnailOnParse,
316 'dbType' => $wgDBtype,
317 'dbServer' => $wgDBserver,
318 'dbUser' => $wgDBuser,
319 'dbPassword' => $wgDBpassword,
320 'dbName' => $wgSharedUploadDBname,
321 'dbFlags' => ( $wgDebugDumpSql ? DBO_DEBUG : 0 ) | DBO_DEFAULT,
322 'tablePrefix' => $wgSharedUploadDBprefix,
323 'hasSharedCache' => $wgCacheSharedUploads,
324 'descBaseUrl' => $wgRepositoryBaseUrl,
325 'fetchDescription' => $wgFetchCommonsDescriptions,
326 ];
327 } else {
328 $wgForeignFileRepos[] = [
329 'class' => FileRepo::class,
330 'name' => 'shared',
331 'directory' => $wgSharedUploadDirectory,
332 'url' => $wgSharedUploadPath,
333 'hashLevels' => $wgHashedSharedUploadDirectory ? 2 : 0,
334 'thumbScriptUrl' => $wgSharedThumbnailScriptPath,
335 'transformVia404' => !$wgGenerateThumbnailOnParse,
336 'descBaseUrl' => $wgRepositoryBaseUrl,
337 'fetchDescription' => $wgFetchCommonsDescriptions,
338 ];
339 }
340 }
341 if ( $wgUseInstantCommons ) {
342 $wgForeignFileRepos[] = [
343 'class' => ForeignAPIRepo::class,
344 'name' => 'wikimediacommons',
345 'apibase' => 'https://commons.wikimedia.org/w/api.php',
346 'url' => 'https://upload.wikimedia.org/wikipedia/commons',
347 'thumbUrl' => 'https://upload.wikimedia.org/wikipedia/commons/thumb',
348 'hashLevels' => 2,
349 'transformVia404' => true,
350 'fetchDescription' => true,
351 'descriptionCacheExpiry' => 43200,
352 'apiThumbCacheExpiry' => 0,
353 ];
354 }
355 foreach ( $wgForeignFileRepos as &$repo ) {
356 if ( !isset( $repo['directory'] ) && $repo['class'] === ForeignAPIRepo::class ) {
357 $repo['directory'] = $wgUploadDirectory; // b/c
358 }
359 if ( !isset( $repo['backend'] ) ) {
360 $repo['backend'] = $repo['name'] . '-backend';
361 }
362 }
363 unset( $repo ); // no global pollution; destroy reference
364
365 $rcMaxAgeDays = $wgRCMaxAge / ( 3600 * 24 );
366 // Ensure that default user options are not invalid, since that breaks Special:Preferences
367 $wgDefaultUserOptions['rcdays'] = min(
368 $wgDefaultUserOptions['rcdays'],
369 ceil( $rcMaxAgeDays )
370 );
371 $wgDefaultUserOptions['watchlistdays'] = min(
372 $wgDefaultUserOptions['watchlistdays'],
373 ceil( $rcMaxAgeDays )
374 );
375 unset( $rcMaxAgeDays );
376
377 if ( $wgSkipSkin ) {
378 // Hard deprecated in 1.34.
379 wfDeprecated( '$wgSkipSkin – use $wgSkipSkins instead', '1.23' );
380 $wgSkipSkins[] = $wgSkipSkin;
381 }
382
383 $wgSkipSkins[] = 'fallback';
384 $wgSkipSkins[] = 'apioutput';
385
386 if ( $wgLocalInterwiki ) {
387 // Hard deprecated in 1.34.
388 wfDeprecated( '$wgLocalInterwiki – use $wgLocalInterwikis instead', '1.23' );
389 // @phan-suppress-next-line PhanUndeclaredVariableDim
390 array_unshift( $wgLocalInterwikis, $wgLocalInterwiki );
391 }
392
393 // Set default shared prefix
394 if ( $wgSharedPrefix === false ) {
395 $wgSharedPrefix = $wgDBprefix;
396 }
397
398 // Set default shared schema
399 if ( $wgSharedSchema === false ) {
400 $wgSharedSchema = $wgDBmwschema;
401 }
402
403 if ( !$wgCookiePrefix ) {
404 if ( $wgSharedDB && $wgSharedPrefix && in_array( 'user', $wgSharedTables ) ) {
405 $wgCookiePrefix = $wgSharedDB . '_' . $wgSharedPrefix;
406 } elseif ( $wgSharedDB && in_array( 'user', $wgSharedTables ) ) {
407 $wgCookiePrefix = $wgSharedDB;
408 } elseif ( $wgDBprefix ) {
409 $wgCookiePrefix = $wgDBname . '_' . $wgDBprefix;
410 } else {
411 $wgCookiePrefix = $wgDBname;
412 }
413 }
414 $wgCookiePrefix = strtr( $wgCookiePrefix, '=,; +."\'\\[', '__________' );
415
416 if ( $wgEnableEmail ) {
417 $wgUseEnotif = $wgEnotifUserTalk || $wgEnotifWatchlist;
418 } else {
419 // Disable all other email settings automatically if $wgEnableEmail
420 // is set to false. - T65678
421 $wgAllowHTMLEmail = false;
422 $wgEmailAuthentication = false; // do not require auth if you're not sending email anyway
423 $wgEnableUserEmail = false;
424 $wgEnotifFromEditor = false;
425 $wgEnotifImpersonal = false;
426 $wgEnotifMaxRecips = 0;
427 $wgEnotifMinorEdits = false;
428 $wgEnotifRevealEditorAddress = false;
429 $wgEnotifUseRealName = false;
430 $wgEnotifUserTalk = false;
431 $wgEnotifWatchlist = false;
432 unset( $wgGroupPermissions['user']['sendemail'] );
433 $wgUseEnotif = false;
434 $wgUserEmailUseReplyTo = false;
435 $wgUsersNotifiedOnAllChanges = [];
436 }
437
438 if ( $wgMetaNamespace === false ) {
439 $wgMetaNamespace = str_replace( ' ', '_', $wgSitename );
440 }
441
442 // Ensure the minimum chunk size is less than PHP upload limits or the maximum
443 // upload size.
444 $wgMinUploadChunkSize = min(
445 $wgMinUploadChunkSize,
446 UploadBase::getMaxUploadSize( 'file' ),
447 UploadBase::getMaxPhpUploadSize(),
448 ( wfShorthandToInteger(
449 ini_get( 'post_max_size' ) ?: ini_get( 'hhvm.server.max_post_size' ),
450 PHP_INT_MAX
451 ) ?: PHP_INT_MAX ) - 1024 // Leave some room for other POST parameters
452 );
453
454 /**
455 * Definitions of the NS_ constants are in Defines.php
456 * @private
457 */
458 $wgCanonicalNamespaceNames = NamespaceInfo::$canonicalNames;
459
460 /// @todo UGLY UGLY
461 if ( is_array( $wgExtraNamespaces ) ) {
462 $wgCanonicalNamespaceNames += $wgExtraNamespaces;
463 }
464
465 // Hard-deprecate setting $wgDummyLanguageCodes in LocalSettings.php
466 if ( count( $wgDummyLanguageCodes ) !== 0 ) {
467 wfDeprecated( '$wgDummyLanguageCodes', '1.29' );
468 }
469 // Merge in the legacy language codes, incorporating overrides from the config
470 $wgDummyLanguageCodes += [
471 // Internal language codes of the private-use area which get mapped to
472 // themselves.
473 'qqq' => 'qqq', // Used for message documentation
474 'qqx' => 'qqx', // Used for viewing message keys
475 ] + $wgExtraLanguageCodes + LanguageCode::getDeprecatedCodeMapping();
476 // Merge in (inverted) BCP 47 mappings
477 foreach ( LanguageCode::getNonstandardLanguageCodeMapping() as $code => $bcp47 ) {
478 $bcp47 = strtolower( $bcp47 ); // force case-insensitivity
479 if ( !isset( $wgDummyLanguageCodes[$bcp47] ) ) {
480 $wgDummyLanguageCodes[$bcp47] = $wgDummyLanguageCodes[$code] ?? $code;
481 }
482 }
483
484 // These are now the same, always
485 // To determine the user language, use $wgLang->getCode()
486 $wgContLanguageCode = $wgLanguageCode;
487
488 // Temporary backwards-compatibility reading of old Squid-named CDN settings as of MediaWiki 1.34,
489 // to support sysadmins who fail to update their settings immediately:
490
491 if ( isset( $wgUseSquid ) ) {
492 // If the sysadmin is still setting a value of $wgUseSquid to true but $wgUseCdn is the default of
493 // false, to be safe, assume they do want this still, so enable it.
494 if ( !$wgUseCdn && $wgUseSquid ) {
495 $wgUseCdn = $wgUseSquid;
496 wfDeprecated( '$wgUseSquid enabled but $wgUseCdn disabled; enabling CDN functions', '1.34' );
497 }
498 } else {
499 // Backwards-compatibility for extensions that read this value.
500 $wgUseSquid = $wgUseCdn;
501 }
502
503 if ( isset( $wgSquidServers ) ) {
504 // If the sysadmin is still setting a value of $wgSquidServers but $wgCdnServers is the default of
505 // empty, to be safe, assume they do want these servers to be still used, so use them.
506 if ( !empty( $wgSquidServers ) && empty( $wgCdnServers ) ) {
507 $wgCdnServers = $wgSquidServers;
508 wfDeprecated( '$wgSquidServers set, $wgCdnServers empty; using them', '1.34' );
509 }
510 } else {
511 // Backwards-compatibility for extensions that read this value.
512 $wgSquidServers = $wgCdnServers;
513 }
514
515 if ( isset( $wgSquidServersNoPurge ) ) {
516 // If the sysadmin is still setting values in $wgSquidServersNoPurge but $wgCdnServersNoPurge is
517 // the default of empty, to be safe, assume they do want these servers to be still used, so use
518 // them.
519 if ( !empty( $wgSquidServersNoPurge ) && empty( $wgCdnServersNoPurge ) ) {
520 $wgCdnServersNoPurge = $wgSquidServersNoPurge;
521 wfDeprecated( '$wgSquidServersNoPurge set, $wgCdnServersNoPurge empty; using them', '1.34' );
522 }
523 } else {
524 // Backwards-compatibility for extensions that read this value.
525 $wgSquidServersNoPurge = $wgCdnServersNoPurge;
526 }
527
528 if ( isset( $wgSquidMaxage ) ) {
529 // If the sysadmin is still setting a value of $wgSquidMaxage and it's higher than $wgCdnMaxAge,
530 // to be safe, assume they want the higher (lower performance requirement) value, so use that.
531 if ( $wgCdnMaxAge < $wgSquidMaxage ) {
532 $wgCdnMaxAge = $wgSquidMaxage;
533 wfDeprecated( '$wgSquidMaxage set higher than $wgCdnMaxAge; using the higher value', '1.34' );
534 }
535 } else {
536 // Backwards-compatibility for extensions that read this value.
537 $wgSquidMaxage = $wgCdnMaxAge;
538 }
539
540 // Blacklisted file extensions shouldn't appear on the "allowed" list
541 $wgFileExtensions = array_values( array_diff( $wgFileExtensions, $wgFileBlacklist ) );
542
543 if ( $wgInvalidateCacheOnLocalSettingsChange ) {
544 Wikimedia\suppressWarnings();
545 $wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', filemtime( "$IP/LocalSettings.php" ) ) );
546 Wikimedia\restoreWarnings();
547 }
548
549 if ( $wgNewUserLog ) {
550 // Add new user log type
551 $wgLogTypes[] = 'newusers';
552 $wgLogNames['newusers'] = 'newuserlogpage';
553 $wgLogHeaders['newusers'] = 'newuserlogpagetext';
554 $wgLogActionsHandlers['newusers/newusers'] = NewUsersLogFormatter::class;
555 $wgLogActionsHandlers['newusers/create'] = NewUsersLogFormatter::class;
556 $wgLogActionsHandlers['newusers/create2'] = NewUsersLogFormatter::class;
557 $wgLogActionsHandlers['newusers/byemail'] = NewUsersLogFormatter::class;
558 $wgLogActionsHandlers['newusers/autocreate'] = NewUsersLogFormatter::class;
559 }
560
561 if ( $wgPageCreationLog ) {
562 // Add page creation log type
563 $wgLogTypes[] = 'create';
564 $wgLogActionsHandlers['create/create'] = LogFormatter::class;
565 }
566
567 if ( $wgPageLanguageUseDB ) {
568 $wgLogTypes[] = 'pagelang';
569 $wgLogActionsHandlers['pagelang/pagelang'] = PageLangLogFormatter::class;
570 }
571
572 if ( $wgCookieSecure === 'detect' ) {
573 $wgCookieSecure = ( WebRequest::detectProtocol() === 'https' );
574 }
575
576 if ( $wgProfileOnly ) {
577 // Hard deprecated in 1.34.
578 wfDeprecated(
579 '$wgProfileOnly set the log file in $wgDebugLogGroups[\'profileoutput\'] instead',
580 '1.23'
581 );
582 $wgDebugLogGroups['profileoutput'] = $wgDebugLogFile;
583 $wgDebugLogFile = '';
584 }
585
586 // Backwards compatibility with old password limits
587 if ( $wgMinimalPasswordLength !== false ) {
588 $wgPasswordPolicy['policies']['default']['MinimalPasswordLength'] = $wgMinimalPasswordLength;
589 }
590
591 if ( $wgMaximalPasswordLength !== false ) {
592 $wgPasswordPolicy['policies']['default']['MaximalPasswordLength'] = $wgMaximalPasswordLength;
593 }
594
595 if ( $wgPHPSessionHandling !== 'enable' &&
596 $wgPHPSessionHandling !== 'warn' &&
597 $wgPHPSessionHandling !== 'disable'
598 ) {
599 $wgPHPSessionHandling = 'warn';
600 }
601 if ( defined( 'MW_NO_SESSION' ) ) {
602 // If the entry point wants no session, force 'disable' here unless they
603 // specifically set it to the (undocumented) 'warn'.
604 // @phan-suppress-next-line PhanUndeclaredConstant
605 $wgPHPSessionHandling = MW_NO_SESSION === 'warn' ? 'warn' : 'disable';
606 }
607
608 MWDebug::setup();
609
610 // Reset the global service locator, so any services that have already been created will be
611 // re-created while taking into account any custom settings and extensions.
612 MediaWikiServices::resetGlobalInstance( new GlobalVarConfig(), 'quick' );
613
614 // Define a constant that indicates that the bootstrapping of the service locator
615 // is complete.
616 define( 'MW_SERVICE_BOOTSTRAP_COMPLETE', 1 );
617
618 MWExceptionHandler::installHandler();
619
620 // T48998: Bail out early if $wgArticlePath is non-absolute
621 foreach ( [ 'wgArticlePath', 'wgVariantArticlePath' ] as $varName ) {
622 if ( $$varName && !preg_match( '/^(https?:\/\/|\/)/', $$varName ) ) {
623 throw new FatalError(
624 "If you use a relative URL for \$$varName, it must start " .
625 'with a slash (<code>/</code>).<br><br>See ' .
626 "<a href=\"https://www.mediawiki.org/wiki/Manual:\$$varName\">" .
627 "https://www.mediawiki.org/wiki/Manual:\$$varName</a>."
628 );
629 }
630 }
631
632 if ( $wgCanonicalServer === false ) {
633 $wgCanonicalServer = wfExpandUrl( $wgServer, PROTO_HTTP );
634 }
635
636 // Set server name
637 $serverParts = wfParseUrl( $wgCanonicalServer );
638 if ( $wgServerName !== false ) {
639 wfWarn( '$wgServerName should be derived from $wgCanonicalServer, '
640 . 'not customized. Overwriting $wgServerName.' );
641 }
642 $wgServerName = $serverParts['host'];
643 unset( $serverParts );
644
645 // Set defaults for configuration variables
646 // that are derived from the server name by default
647 // Note: $wgEmergencyContact and $wgPasswordSender may be false or empty string (T104142)
648 if ( !$wgEmergencyContact ) {
649 $wgEmergencyContact = 'wikiadmin@' . $wgServerName;
650 }
651 if ( !$wgPasswordSender ) {
652 $wgPasswordSender = 'apache@' . $wgServerName;
653 }
654 if ( !$wgNoReplyAddress ) {
655 $wgNoReplyAddress = $wgPasswordSender;
656 }
657
658 if ( $wgSecureLogin && substr( $wgServer, 0, 2 ) !== '//' ) {
659 $wgSecureLogin = false;
660 wfWarn( 'Secure login was enabled on a server that only supports '
661 . 'HTTP or HTTPS. Disabling secure login.' );
662 }
663
664 $wgVirtualRestConfig['global']['domain'] = $wgCanonicalServer;
665
666 // Now that GlobalFunctions is loaded, set defaults that depend on it.
667 if ( $wgTmpDirectory === false ) {
668 $wgTmpDirectory = wfTempDir();
669 }
670
671 // We don't use counters anymore. Left here for extensions still
672 // expecting this to exist. Should be removed sometime 1.26 or later.
673 if ( !isset( $wgDisableCounters ) ) {
674 $wgDisableCounters = true;
675 }
676
677 if ( $wgMainWANCache === false ) {
678 // Setup a WAN cache from $wgMainCacheType with no relayer.
679 // Sites using multiple datacenters can configure a relayer.
680 $wgMainWANCache = 'mediawiki-main-default';
681 $wgWANObjectCaches[$wgMainWANCache] = [
682 'class' => WANObjectCache::class,
683 'cacheId' => $wgMainCacheType
684 ];
685 }
686
687 if ( $wgSharedDB && $wgSharedTables ) {
688 // Apply $wgSharedDB table aliases for the local LB (all non-foreign DB connections)
689 MediaWikiServices::getInstance()->getDBLoadBalancer()->setTableAliases(
690 array_fill_keys(
691 $wgSharedTables,
692 [
693 'dbname' => $wgSharedDB,
694 'schema' => $wgSharedSchema,
695 'prefix' => $wgSharedPrefix
696 ]
697 )
698 );
699 }
700
701 // Raise the memory limit if it's too low
702 // Note, this makes use of wfDebug, and thus should not be before
703 // MWDebug::init() is called.
704 wfMemoryLimit( $wgMemoryLimit );
705
706 /**
707 * Set up the timezone, suppressing the pseudo-security warning in PHP 5.1+
708 * that happens whenever you use a date function without the timezone being
709 * explicitly set. Inspired by phpMyAdmin's treatment of the problem.
710 */
711 if ( is_null( $wgLocaltimezone ) ) {
712 Wikimedia\suppressWarnings();
713 $wgLocaltimezone = date_default_timezone_get();
714 Wikimedia\restoreWarnings();
715 }
716
717 date_default_timezone_set( $wgLocaltimezone );
718 if ( is_null( $wgLocalTZoffset ) ) {
719 $wgLocalTZoffset = date( 'Z' ) / 60;
720 }
721 // The part after the System| is ignored, but rest of MW fills it
722 // out as the local offset.
723 $wgDefaultUserOptions['timecorrection'] = "System|$wgLocalTZoffset";
724
725 if ( !$wgDBerrorLogTZ ) {
726 $wgDBerrorLogTZ = $wgLocaltimezone;
727 }
728
729 // Initialize the request object in $wgRequest
730 $wgRequest = RequestContext::getMain()->getRequest(); // BackCompat
731 // Set user IP/agent information for agent session consistency purposes
732 $cpPosInfo = LBFactory::getCPInfoFromCookieValue(
733 // The cookie has no prefix and is set by MediaWiki::preOutputCommit()
734 $wgRequest->getCookie( 'cpPosIndex', '' ),
735 // Mitigate broken client-side cookie expiration handling (T190082)
736 time() - ChronologyProtector::POSITION_COOKIE_TTL
737 );
738 MediaWikiServices::getInstance()->getDBLoadBalancerFactory()->setRequestInfo( [
739 'IPAddress' => $wgRequest->getIP(),
740 'UserAgent' => $wgRequest->getHeader( 'User-Agent' ),
741 'ChronologyProtection' => $wgRequest->getHeader( 'MediaWiki-Chronology-Protection' ),
742 'ChronologyPositionIndex' => $wgRequest->getInt( 'cpPosIndex', $cpPosInfo['index'] ),
743 'ChronologyClientId' => $cpPosInfo['clientId']
744 ?? $wgRequest->getHeader( 'MediaWiki-Chronology-Client-Id' )
745 ] );
746 unset( $cpPosInfo );
747 // Make sure that object caching does not undermine the ChronologyProtector improvements
748 if ( $wgRequest->getCookie( 'UseDC', '' ) === 'master' ) {
749 // The user is pinned to the primary DC, meaning that they made recent changes which should
750 // be reflected in their subsequent web requests. Avoid the use of interim cache keys because
751 // they use a blind TTL and could be stale if an object changes twice in a short time span.
752 MediaWikiServices::getInstance()->getMainWANObjectCache()->useInterimHoldOffCaching( false );
753 }
754
755 // Useful debug output
756 if ( $wgCommandLineMode ) {
757 if ( isset( $self ) ) {
758 wfDebug( "\n\nStart command line script $self\n" );
759 }
760 } else {
761 $debug = "\n\nStart request {$wgRequest->getMethod()} {$wgRequest->getRequestURL()}\n";
762 $debug .= "HTTP HEADERS:\n";
763 foreach ( $wgRequest->getAllHeaders() as $name => $value ) {
764 $debug .= "$name: $value\n";
765 }
766 wfDebug( $debug );
767 }
768
769 $wgMemc = ObjectCache::getLocalClusterInstance();
770 $messageMemc = wfGetMessageCacheStorage();
771
772 // Most of the config is out, some might want to run hooks here.
773 Hooks::run( 'SetupAfterCache' );
774
775 /**
776 * @var Language $wgContLang
777 * @deprecated since 1.32, use the ContentLanguage service directly
778 */
779 $wgContLang = MediaWikiServices::getInstance()->getContentLanguage();
780
781 // Now that variant lists may be available...
782 $wgRequest->interpolateTitle();
783
784 /**
785 * @var MediaWiki\Session\SessionId|null $wgInitialSessionId The persistent
786 * session ID (if any) loaded at startup
787 */
788 $wgInitialSessionId = null;
789 if ( !defined( 'MW_NO_SESSION' ) && !$wgCommandLineMode ) {
790 // If session.auto_start is there, we can't touch session name
791 if ( $wgPHPSessionHandling !== 'disable' && !wfIniGetBool( 'session.auto_start' ) ) {
792 session_name( $wgSessionName ?: $wgCookiePrefix . '_session' );
793 }
794
795 // Create the SessionManager singleton and set up our session handler,
796 // unless we're specifically asked not to.
797 if ( !defined( 'MW_NO_SESSION_HANDLER' ) ) {
798 MediaWiki\Session\PHPSessionHandler::install(
799 MediaWiki\Session\SessionManager::singleton()
800 );
801 }
802
803 // Initialize the session
804 try {
805 $session = MediaWiki\Session\SessionManager::getGlobalSession();
806 } catch ( OverflowException $ex ) {
807 if ( isset( $ex->sessionInfos ) && count( $ex->sessionInfos ) >= 2 ) {
808 // The exception is because the request had multiple possible
809 // sessions tied for top priority. Report this to the user.
810 $list = [];
811 foreach ( $ex->sessionInfos as $info ) {
812 $list[] = $info->getProvider()->describe( $wgContLang );
813 }
814 $list = $wgContLang->listToText( $list );
815 throw new HttpError( 400,
816 Message::newFromKey( 'sessionmanager-tie', $list )->inLanguage( $wgContLang )->plain()
817 );
818 }
819
820 // Not the one we want, rethrow
821 throw $ex;
822 }
823
824 if ( $session->isPersistent() ) {
825 $wgInitialSessionId = $session->getSessionId();
826 }
827
828 $session->renew();
829 if ( MediaWiki\Session\PHPSessionHandler::isEnabled() &&
830 ( $session->isPersistent() || $session->shouldRememberUser() ) &&
831 session_id() !== $session->getId()
832 ) {
833 // Start the PHP-session for backwards compatibility
834 if ( session_id() !== '' ) {
835 wfDebugLog( 'session', 'PHP session {old_id} was already started, changing to {new_id}', 'all', [
836 'old_id' => session_id(),
837 'new_id' => $session->getId(),
838 ] );
839 session_write_close();
840 }
841 session_id( $session->getId() );
842 session_start();
843 }
844
845 unset( $session );
846 } else {
847 // Even if we didn't set up a global Session, still install our session
848 // handler unless specifically requested not to.
849 if ( !defined( 'MW_NO_SESSION_HANDLER' ) ) {
850 MediaWiki\Session\PHPSessionHandler::install(
851 MediaWiki\Session\SessionManager::singleton()
852 );
853 }
854 }
855
856 /**
857 * @var User $wgUser
858 */
859 $wgUser = RequestContext::getMain()->getUser(); // BackCompat
860
861 /**
862 * @var Language $wgLang
863 */
864 $wgLang = new StubUserLang;
865
866 /**
867 * @var OutputPage $wgOut
868 */
869 $wgOut = RequestContext::getMain()->getOutput(); // BackCompat
870
871 /**
872 * @var Parser $wgParser
873 * @deprecated since 1.32, use MediaWikiServices::getInstance()->getParser() instead
874 */
875 $wgParser = new StubObject( 'wgParser', function () {
876 return MediaWikiServices::getInstance()->getParser();
877 } );
878
879 /**
880 * @var Title $wgTitle
881 */
882 $wgTitle = null;
883
884 // Extension setup functions
885 // Entries should be added to this variable during the inclusion
886 // of the extension file. This allows the extension to perform
887 // any necessary initialisation in the fully initialised environment
888 foreach ( $wgExtensionFunctions as $func ) {
889 call_user_func( $func );
890 }
891
892 // If the session user has a 0 id but a valid name, that means we need to
893 // autocreate it.
894 if ( !defined( 'MW_NO_SESSION' ) && !$wgCommandLineMode ) {
895 $sessionUser = MediaWiki\Session\SessionManager::getGlobalSession()->getUser();
896 if ( $sessionUser->getId() === 0 && User::isValidUserName( $sessionUser->getName() ) ) {
897 $res = MediaWiki\Auth\AuthManager::singleton()->autoCreateUser(
898 $sessionUser,
899 MediaWiki\Auth\AuthManager::AUTOCREATE_SOURCE_SESSION,
900 true
901 );
902 \MediaWiki\Logger\LoggerFactory::getInstance( 'authevents' )->info( 'Autocreation attempt', [
903 'event' => 'autocreate',
904 'status' => $res,
905 ] );
906 unset( $res );
907 }
908 unset( $sessionUser );
909 }
910
911 if ( !$wgCommandLineMode ) {
912 Pingback::schedulePingback();
913 }
914
915 $wgFullyInitialised = true;