Setup.php File Reference

The setup for all MediaWiki processes (both web-based and CLI). More...

Go to the source code of this file.

Variables
	$cpPosInfo
	$rcMaxAgeDays = $wgRCMaxAge / ( 3600 * 24 )
if($wgServer===false) if( $wgCanonicalServer===false)	$serverParts = wfParseUrl( $wgCanonicalServer )
	$wgCanonicalNamespaceNames = NamespaceInfo::CANONICAL_NAMES
	Definitions of the NS_ constants are in Defines.php.
	$wgContLang = MediaWikiServices::getInstance()->getContentLanguage()
if(! $wgCookiePrefix)	$wgCookiePrefix = strtr( $wgCookiePrefix, '=,; +."\'\\[', '__________' )
	$wgDefaultUserOptions ['rcdays']
if( $wgLocalTZoffset===null)	$wgDefaultUserOptions ['timecorrection'] = "System|$wgLocalTZoffset"
	$wgDefaultUserOptions ['watchlistdays']
if(is_array($wgExtraNamespaces)) if(count( $wgDummyLanguageCodes) !==0)	$wgDummyLanguageCodes
	$wgEmailAuthentication = false
	$wgEnableUserEmail = false
	$wgEnotifFromEditor = false
	$wgEnotifImpersonal = false
	$wgEnotifMaxRecips = 0
	$wgEnotifMinorEdits = false
	$wgEnotifRevealEditorAddress = false
	$wgEnotifUseRealName = false
	$wgEnotifUserTalk = false
	$wgEnotifWatchlist = false
if( $wgScript===false) if($wgLoadScript===false) if( $wgRestPath===false) if($wgArticlePath===false) if( $wgResourceBasePath===null) if($wgStylePath===false) if( $wgLocalStylePath===false) if($wgExtensionAssetsPath===false) if( $wgLogos !==false &&isset( $wgLogos['1x'])) if($wgLogo===false) if( $wgUploadPath===false) if($wgUploadDirectory===false) if( $wgReadOnlyFile===false) if($wgFileCacheDirectory===false) if( $wgDeletedDirectory===false) if($wgGitInfoCacheDirectory===false &&$wgCacheDirectory !==false) if( $wgSharedPrefix===false) if($wgSharedSchema===false) if( $wgMetaNamespace===false)	$wgFileExtensions = array_values( array_diff( $wgFileExtensions, $wgFileBlacklist ) )
	Expand dynamic defaults and shortcuts.
foreach( $wgExtensionFunctions as $func) if(!defined('MW_NO_SESSION') &&! $wgCommandLineMode) if(! $wgCommandLineMode)	$wgFullyInitialised = true
	$wgGalleryOptions
	Default parameters for the "<gallery>" tag.
MediaWiki Session SessionId null	$wgInitialSessionId = null
	The persistent session ID (if any) loaded at startup.
	$wgLang = new StubUserLang
	$wgLockManagers []
	Initialise $wgLockManagers to include basic FS version.
	$wgMemc = ObjectCache::getLocalClusterInstance()
if( $wgRightsIcon) if(isset($wgFooterIcons[ 'copyright'][ 'copyright']) &&$wgFooterIcons[ 'copyright'][ 'copyright']===[]) if(isset( $wgFooterIcons['poweredby']) &&isset( $wgFooterIcons['poweredby']['mediawiki']) && $wgFooterIcons['poweredby']['mediawiki']['src']===null)	$wgNamespaceProtection [NS_MEDIAWIKI] = 'editinterface'
	Unconditional protection for NS_MEDIAWIKI since otherwise it's too easy for a sysadmin to set $wgNamespaceProtection incorrectly and leave the wiki insecure.
	$wgOut = RequestContext::getMain()->getOutput()
	$wgParser
if(! $wgDBerrorLogTZ)	$wgRequest = RequestContext::getMain()->getRequest()
if(!defined( 'MEDIAWIKI'))	$wgScopeTest = 'MediaWiki Setup.php scope test'
	Environment checks.
if( $wgServerName !==false)	$wgServerName = $serverParts['host']
	$wgTitle = null
	$wgUseEnotif = false
	$wgUserEmailUseReplyTo = false
	$wgUsersNotifiedOnAllChanges = []
if(! $wgEmergencyContact) if(! $wgPasswordSender) if(! $wgNoReplyAddress) if( $wgSecureLogin &&substr( $wgServer, 0, 2) !=='//')	$wgVirtualRestConfig ['global']['domain'] = $wgCanonicalServer
if(defined( 'MW_CONFIG_CALLBACK'))	else
	Load LocalSettings.php.
if(ini_get('mbstring.func_overload'))	if (!defined('MW_ENTRY_POINT'))
	Pre-config setup: Before loading LocalSettings.php.
const	MW_SERVICE_BOOTSTRAP_COMPLETE 1

Detailed Description

The setup for all MediaWiki processes (both web-based and CLI).

This file must be included by all entry points (such as WebStart.php and doMaintenance.php).

• The entry point MUST do these:
  • define the 'MEDIAWIKI' constant.
  • define the $IP global variable.
• The entry point SHOULD do these:
  • define the 'MW_ENTRY_POINT' constant.
  • display an error if MW_CONFIG_CALLBACK is not defined and the the file specified in MW_CONFIG_FILE (or the $IP/LocalSettings.php default) does not exist. The error should either be sent before and instead of the Setup.php inclusion, or (if it needs classes and dependencies from core) the erorr can be displayed via a MW_CONFIG_CALLBACK, which must then abort the process to prevent the rest of Setup.php from executing.

It does:

• run-time environment checks,
• load autoloaders, constants, default settings, and global functions,
• load the site configuration (e.g. LocalSettings.php),
• load the enabled extensions (via ExtensionRegistry),
• expand any dynamic site configuration defaults and shortcuts
• initialization of:
  • PHP run-time (setlocale, memory limit, default date timezone)
  • the debug logger (MWDebug)
  • the service container (MediaWikiServices)
  • the exception handler (MWExceptionHandler)
  • the session manager (SessionManager)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. http://www.gnu.org/copyleft/gpl.html

Definition in file Setup.php.

Variable Documentation

$cpPosInfo

$cpPosInfo

Initial value:

= LBFactory::getCPInfoFromCookieValue(
    
    $wgRequest->getCookie( 'cpPosIndex', '' ),
    
    time() - ChronologyProtector::POSITION_COOKIE_TTL
)

Definition at line 645 of file Setup.php.

$rcMaxAgeDays

$rcMaxAgeDays = $wgRCMaxAge / ( 3600 * 24 )

Definition at line 399 of file Setup.php.

$serverParts

if( $wgServer===false) if ($wgCanonicalServer===false) $serverParts = wfParseUrl( $wgCanonicalServer )

Definition at line 557 of file Setup.php.

$wgCanonicalNamespaceNames

$wgCanonicalNamespaceNames = NamespaceInfo::CANONICAL_NAMES

Definitions of the NS_ constants are in Defines.php.

Definition at line 450 of file Setup.php.

Referenced by wfInstallerMain().

$wgContLang

Language $wgContLang = MediaWikiServices::getInstance()->getContentLanguage()

Deprecated:

since 1.32, use the ContentLanguage service directly

Definition at line 700 of file Setup.php.

Referenced by CliInstaller\__construct(), and WebInstaller\setupLanguage().

$wgCookiePrefix

if (! $wgCookiePrefix) $wgCookiePrefix = strtr( $wgCookiePrefix, '=,; +."\'\\[', '__________' )

Definition at line 422 of file Setup.php.

$wgDefaultUserOptions [1/3]

$wgDefaultUserOptions[ 'rcdays']

Initial value:

= min(
    $wgDefaultUserOptions['rcdays'],
    ceil( $rcMaxAgeDays )
)

Definition at line 401 of file Setup.php.

$wgDefaultUserOptions [2/3]

if ($wgLocalTZoffset===null) $wgDefaultUserOptions[ 'timecorrection'] = "System|$wgLocalTZoffset"

Definition at line 636 of file Setup.php.

$wgDefaultUserOptions [3/3]

$wgDefaultUserOptions[ 'watchlistdays']

Initial value:

= min(
    $wgDefaultUserOptions['watchlistdays'],
    ceil( $rcMaxAgeDays )
)

Definition at line 405 of file Setup.php.

$wgDummyLanguageCodes

if(is_array( $wgExtraNamespaces)) if (count($wgDummyLanguageCodes) !==0) $wgDummyLanguageCodes

Initial value:

= [
    
    
    'qqq' => 'qqq', 
    'qqx' => 'qqx', 
] + $wgExtraLanguageCodes + LanguageCode::getDeprecatedCodeMapping()

Todo:

UGLY UGLY

Definition at line 462 of file Setup.php.

$wgEmailAuthentication

$wgEmailAuthentication = false

Definition at line 430 of file Setup.php.

$wgEnableUserEmail

$wgEnableUserEmail = false

Definition at line 431 of file Setup.php.

$wgEnotifFromEditor

$wgEnotifFromEditor = false

Definition at line 432 of file Setup.php.

$wgEnotifImpersonal

$wgEnotifImpersonal = false

Definition at line 433 of file Setup.php.

$wgEnotifMaxRecips

$wgEnotifMaxRecips = 0

Definition at line 434 of file Setup.php.

$wgEnotifMinorEdits

$wgEnotifMinorEdits = false

Definition at line 435 of file Setup.php.

$wgEnotifRevealEditorAddress

$wgEnotifRevealEditorAddress = false

Definition at line 436 of file Setup.php.

$wgEnotifUseRealName

$wgEnotifUseRealName = false

Definition at line 437 of file Setup.php.

$wgEnotifUserTalk

$wgEnotifUserTalk = false

Definition at line 438 of file Setup.php.

$wgEnotifWatchlist

$wgEnotifWatchlist = false

Definition at line 439 of file Setup.php.

$wgFileExtensions

if($wgScript===false) if( $wgLoadScript===false) if($wgRestPath===false) if( $wgArticlePath===false) if($wgResourceBasePath===null) if( $wgStylePath===false) if($wgLocalStylePath===false) if( $wgExtensionAssetsPath===false) if($wgLogos !==false &&isset($wgLogos[ '1x'])) if( $wgLogo===false) if($wgUploadPath===false) if( $wgUploadDirectory===false) if($wgReadOnlyFile===false) if( $wgFileCacheDirectory===false) if($wgDeletedDirectory===false) if( $wgGitInfoCacheDirectory===false && $wgCacheDirectory !==false) if($wgSharedPrefix===false) if( $wgSharedSchema===false) if ($wgMetaNamespace===false) $wgFileExtensions = array_values( array_diff( $wgFileExtensions, $wgFileBlacklist ) )

Expand dynamic defaults and shortcuts.

Definition at line 243 of file Setup.php.

$wgFullyInitialised

foreach($wgExtensionFunctions as $func) if(!defined( 'MW_NO_SESSION') &&! $wgCommandLineMode) if (! $wgCommandLineMode) $wgFullyInitialised = true

Definition at line 832 of file Setup.php.

Referenced by User\clearInstanceCache(), User\isSafeToLoad(), User\load(), and User\loadFromCache().

$wgGalleryOptions

$wgGalleryOptions

Initial value:

= [
    'imagesPerRow' => 0,
    'imageWidth' => 120,
    'imageHeight' => 120,
    'captionLength' => true,
    'showBytes' => true,
    'showDimensions' => true,
    'mode' => 'traditional',
]

Default parameters for the "<gallery>" tag.

See also

DefaultSettings.php for description of the fields.

Definition at line 303 of file Setup.php.

$wgInitialSessionId

MediaWiki Session SessionId null $wgInitialSessionId = null

The persistent session ID (if any) loaded at startup.

Definition at line 708 of file Setup.php.

Referenced by LoginSignupSpecialPage\hasSessionCookie().

$wgLang

Language $wgLang = new StubUserLang

Definition at line 781 of file Setup.php.

Referenced by ApiMain\__construct(), PermissionsError\__construct(), CliInstaller\__construct(), ParserOptions\__construct(), LogPage\actionText(), SpecialEditWatchlist\buildTools(), MediaWiki\SpecialPage\SpecialPageFactory\capturePath(), MediaWiki\Permissions\PermissionManager\checkActionPermissions(), UploadBase\checkUnwantedFileExtensions(), Installer\envCheckDB(), LocalFileRestoreBatch\execute(), WebInstallerLanguage\execute(), WebInstallerOptions\execute(), UpdateMediaWiki\execute(), StubUserLang\findVariantLink(), Linker\formatAutocomments(), FeedUtils\formatDiffRow(), SpecialVersion\getCopyrightAndAuthorList(), User\getDatePreference(), File\getDescriptionText(), ForeignDBFile\getDescriptionText(), MediaHandler\getGeneralShortDesc(), WebInstallerOutput\getLanguage(), ImageHandler\getLongDesc(), SvgHandler\getLongDesc(), GIFHandler\getLongDesc(), PNGHandler\getLongDesc(), Title\getPageLanguage(), ContentHandler\getPageLanguage(), Title\getPageViewLanguage(), EditPage\getPreviewLimitReport(), ImageHandler\getShortDesc(), SpecialVersion\getVersionLinkedGit(), WebInstallerOptions\makeScreenshotsLink(), Xml\monthSelector(), Html\namespaceSelectorOptions(), User\newFatalPermissionDeniedStatus(), FileDeleteForm\prepareMessage(), Installer\resetMediaWikiServices(), User\sendConfirmationMail(), LoginSignupSpecialPage\setSessionUserForCurrentRequest(), WebInstaller\setupLanguage(), ForeignAPIFile\transform(), Linker\userToolLinks(), wfGetLangObj(), and wfInstallerMain().

$wgLockManagers

$wgLockManagers[]

Initial value:

= [
    'name' => 'fsLockManager',
    'class' => FSLockManager::class,
    'lockDirectory' => "{$wgUploadDirectory}/lockdir",
]

Initialise $wgLockManagers to include basic FS version.

Definition at line 289 of file Setup.php.

$wgMemc

BagOStuff $wgMemc = ObjectCache::getLocalClusterInstance()

Deprecated:

since 1.35, use the LocalServerObjectCache service instead

Definition at line 691 of file Setup.php.

Referenced by Installer\resetMediaWikiServices().

$wgNamespaceProtection

if($wgRightsIcon) if(isset( $wgFooterIcons['copyright']['copyright']) && $wgFooterIcons['copyright']['copyright']===[]) if (isset($wgFooterIcons[ 'poweredby']) &&isset($wgFooterIcons[ 'poweredby'][ 'mediawiki']) &&$wgFooterIcons[ 'poweredby'][ 'mediawiki'][ 'src']===null) $wgNamespaceProtection[NS_MEDIAWIKI] = 'editinterface'

Unconditional protection for NS_MEDIAWIKI since otherwise it's too easy for a sysadmin to set $wgNamespaceProtection incorrectly and leave the wiki insecure.

Note that this is the definition of editinterface and it can be granted to all users if desired.

Definition at line 284 of file Setup.php.

$wgOut

OutputPage $wgOut = RequestContext::getMain()->getOutput()

Definition at line 786 of file Setup.php.

Referenced by MediaWiki\SpecialPage\SpecialPageFactory\capturePath(), FeedUtils\checkFeedOutput(), UploadBase\detectVirus(), FileDeleteForm\execute(), ChannelFeed\httpHeaders(), ThrottledError\report(), BadRequestError\report(), ErrorPageError\report(), PermissionsError\report(), LocalFileLockError\report(), MWException\reportHTML(), MWExceptionRenderer\reportHTML(), FileDeleteForm\setHeaders(), FileDeleteForm\showForm(), FileDeleteForm\showLogEntries(), wfHttpError(), and wfVarDump().

$wgParser

Parser $wgParser

Initial value:

= new DeprecatedGlobal( 'wgParser', function () {
    return MediaWikiServices::getInstance()->getParser();
}, '1.32' )

Deprecated:

since 1.32, use MediaWikiServices::getInstance()->getParser() instead

Definition at line 792 of file Setup.php.

$wgRequest

if (! $wgDBerrorLogTZ) $wgRequest = RequestContext::getMain()->getRequest()

Definition at line 643 of file Setup.php.

Referenced by MediaWiki\SpecialPage\SpecialPageFactory\capturePath(), RecentChange\checkIPAddress(), ChannelFeed\contentType(), ApiEditPage\execute(), FileDeleteForm\execute(), LanguageConverter\findVariantLink(), WebInstaller\getAcceptLanguage(), LanguageConverter\getHeaderVariant(), Title\getLocalURL(), ParserCache\getParserOutputKey(), User\getRequest(), AtomFeed\getSelfUrl(), MWExceptionHandler\getURL(), LanguageConverter\getURLVariant(), RequestContext\importScopedSession(), MediaWiki\Rest\EntryPoint\main(), RecentChange\newLogEntry(), FileDeleteForm\showForm(), OutputPage\transformCssMedia(), wfApiMain(), wfExpandUrl(), wfLoadMain(), wfOpenSearchDescMain(), and wfThumbMain().

$wgScopeTest

if (!defined('MEDIAWIKI')) $wgScopeTest = 'MediaWiki Setup.php scope test'

Environment checks.

These are inline checks done before we include any source files, and thus these conditions may be assumed by all source code.

Definition at line 69 of file Setup.php.

$wgServerName

if ($wgServerName !==false) $wgServerName = $serverParts['host']

Definition at line 562 of file Setup.php.

$wgTitle

Title $wgTitle = null

Definition at line 799 of file Setup.php.

Referenced by MediaWiki\SpecialPage\SpecialPageFactory\capturePath(), Parser\cleanSig(), ApiEditPage\execute(), ApiParse\execute(), Parser\extractSections(), EditPage\getContextTitle(), RequestContext\getTitle(), MediaWiki\main(), MediaWiki\Rest\EntryPoint\main(), Linker\makeExternalLink(), MessageCache\parse(), MediaWiki\performRequest(), Parser\transformMsg(), and wfApiMain().

$wgUseEnotif

$wgUseEnotif = false

Definition at line 441 of file Setup.php.

Referenced by RecentChange\save().

$wgUserEmailUseReplyTo

$wgUserEmailUseReplyTo = false

Definition at line 442 of file Setup.php.

$wgUsersNotifiedOnAllChanges

$wgUsersNotifiedOnAllChanges = []

Definition at line 443 of file Setup.php.

$wgVirtualRestConfig

if(! $wgEmergencyContact) if(! $wgPasswordSender) if(! $wgNoReplyAddress) if ($wgSecureLogin &&substr($wgServer, 0, 2) !=='//') $wgVirtualRestConfig[ 'global'][ 'domain'] = $wgCanonicalServer

Definition at line 584 of file Setup.php.

else

if (!defined('MW_NO_SESSION') &&! $wgCommandLineMode) else

Initial value:

{
    if ( !defined( 'MW_CONFIG_FILE' ) ) {
        define( 'MW_CONFIG_FILE', "$IP/LocalSettings.php" );
    }
    require_once MW_CONFIG_FILE

Load LocalSettings.php.

Definition at line 139 of file Setup.php.

if

if

(

!

defined'MW_ENTRY_POINT'

)

Initial value:

{
    
    
    $wgAllowHTMLEmail = false

Pre-config setup: Before loading LocalSettings.php.

These are changes and additions to runtime that don't vary on site configuration.

Definition at line 85 of file Setup.php.

Referenced by TitleValue\__toString(), and MediaWiki\Revision\RevisionStore\newRevisionsFromBatch().

MW_SERVICE_BOOTSTRAP_COMPLETE

const MW_SERVICE_BOOTSTRAP_COMPLETE 1

Definition at line 538 of file Setup.php.