MediaWiki  master
Installer Class Reference

Base installer class. More...

Inheritance diagram for Installer:
Collaboration diagram for Installer:

Public Member Functions

 __construct ()
 Constructor, always call this from child classes. More...
 
 addInstallStep ( $callback, $findStep='BEGINNING')
 Add an installation step following the given step. More...
 
 dirIsExecutable ( $dir, $url)
 Checks if scripts located in the given directory can be executed via the given URL. More...
 
 disableLinkPopups ()
 
 doEnvironmentChecks ()
 Do initial checks of the PHP environment. More...
 
 doEnvironmentPreps ()
 
 findExtensions ( $directory='extensions')
 Find extensions or skins in a subdirectory of $IP. More...
 
 generateKeys ()
 Generate $wgSecretKey. More...
 
 getAutoExtensionHookContainer ()
 Get the hook container previously populated by includeExtensions(). More...
 
 getCompiledDBs ()
 Get a list of DBs supported by current PHP setup. More...
 
 getDBInstaller ( $type=false)
 Get an instance of DatabaseInstaller for the specified DB type. More...
 
 getDefaultSkin (array $skinNames)
 Returns a default value to be used for $wgDefaultSkin: normally the DefaultSkin from config-schema.yaml, but will fall back to another if the default skin is missing and some other one is present instead. More...
 
 getFakePassword ( $realPassword)
 Get a fake password for sending back to the user in HTML. More...
 
 getParserOptions ()
 
 getVar ( $name, $default=null)
 Get an MW configuration variable, or internal installer configuration variable. More...
 
 parse ( $text, $lineStart=false)
 Convert wikitext $text to HTML. More...
 
 performInstallation ( $startCB, $endCB)
 Actually perform the installation. More...
 
 populateSiteStats (DatabaseInstaller $installer)
 Install step which adds a row to the site_stats table with appropriate initial values. More...
 
 resetMediaWikiServices (Config $installerConfig=null, $serviceOverrides=[], bool $disableStorage=false)
 Reset the global service container and associated global state to accommodate different stages of the installation. More...
 
 restoreLinkPopups ()
 
 restoreServices ()
 Restore services that have been redefined in the early stage of installation. More...
 
 setParserLanguage ( $lang)
 ParserOptions are constructed before we determined the language, so fix it. More...
 
 setPassword ( $name, $value)
 Set a variable which stores a password, except if the new value is a fake password in which case leave it as it is. More...
 
 setVar ( $name, $value)
 Set a MW configuration variable, or internal installer configuration variable. More...
 
 showError ( $msg,... $params)
 Same as showMessage(), but for displaying errors. More...
 
 showMessage ( $msg,... $params)
 UI interface for displaying a short message The parameters are like parameters to wfMessage(). More...
 
 showStatusMessage (Status $status)
 Show a message to the installing user by using a Status object. More...
 

Static Public Member Functions

static apacheModulePresent ( $moduleName)
 Checks for presence of an Apache module. More...
 
static getDBInstallerClass ( $type)
 Get the DatabaseInstaller class name for this type. More...
 
static getDBTypes ()
 Get a list of known DB types. More...
 
static getExistingLocalSettings ()
 Determine if LocalSettings.php exists. More...
 
static getInstallerConfig (Config $baseConfig)
 Constructs a Config object that contains configuration settings that should be overwritten for the installation process. More...
 
static maybeGetWebserverPrimaryGroup ()
 On POSIX systems return the primary group of the webserver we're running under. More...
 
static overrideConfig (SettingsBuilder $settings)
 Override the necessary bits of the config to run an installation. More...
 

Public Attributes

array $licenses
 License types. More...
 
array $rightsProfiles
 User rights profiles. More...
 

Protected Member Functions

 createMainpage (DatabaseInstaller $installer)
 Insert Main Page with default content. More...
 
 createSysop ()
 Create the first user account, grant it sysop, bureaucrat and interface-admin rights. More...
 
 disableTimeLimit ()
 Disable the time limit for execution. More...
 
 doGenerateKeys ( $keys)
 Generate a secret value for variables using a secure generator. More...
 
 envCheck64Bit ()
 Checks if we're running on 64 bit or not. More...
 
 envCheckCache ()
 Environment check for compiled object cache types. More...
 
 envCheckDB ()
 Environment check for DB types. More...
 
 envCheckDiff3 ()
 Search for GNU diff3. More...
 
 envCheckGit ()
 Search for git. More...
 
 envCheckGraphics ()
 Environment check for ImageMagick and GD. More...
 
 envCheckLibicu ()
 Check and display the libicu and Unicode versions. More...
 
 envCheckMemory ()
 Environment check for available memory. More...
 
 envCheckModSecurity ()
 Scare user to death if they have mod_security or mod_security2. More...
 
 envCheckPath ()
 Environment check to inform user which paths we've assumed. More...
 
 envCheckPCRE ()
 Check for known PCRE-related compatibility issues. More...
 
 envCheckServer ()
 Environment check to inform user which server we've assumed. More...
 
 envCheckUploadsDirectory ()
 Environment check for the permissions of the uploads directory. More...
 
 envCheckUploadsServerResponse ()
 
 envGetDefaultServer ()
 Helper function to be called from envPrepServer() More...
 
 envPrepPath ()
 Environment prep for setting $IP and $wgScriptPath. More...
 
 envPrepServer ()
 Environment prep for the server hostname. More...
 
 findExtensionsByType ( $type='extension', $directory='extensions')
 Find extensions or skins, and return an array containing the value for 'Name' for each found extension. More...
 
 getAutoExtensionData ()
 Auto-detect extensions with an extension.json file. More...
 
 getAutoExtensionLegacyHooks ()
 Auto-detect extensions with an old style .php registration file, load the extensions, and return the merged $wgHooks array. More...
 
 getDocUrl ( $page)
 Overridden by WebInstaller to provide lastPage parameters. More...
 
 getExtensionInfo ( $type, $parentRelPath, $name)
 
 getInstallSteps (DatabaseInstaller $installer)
 Get an array of install steps. More...
 
 includeExtensionFiles ( $files)
 Include the specified extension PHP files. More...
 
 includeExtensions ()
 Installs the auto-detected extensions. More...
 

Protected Attributes

HookContainer null $autoExtensionHookContainer
 
array $compiledDBs
 List of detected DBs, access using getCompiledDBs(). More...
 
array $dbInstallers = []
 Cached DB installer instances, access using getDBInstaller(). More...
 
array $envChecks
 A list of environment check methods called by doEnvironmentChecks(). More...
 
array $envPreps
 A list of environment preparation methods called by doEnvironmentPreps(). More...
 
array $extraInstallSteps = []
 Extra steps for installation, for things like DatabaseInstallers to modify. More...
 
array $internalDefaults
 Variables that are stored alongside globals, and are used for any configuration of the installation process aside from the MediaWiki configuration. More...
 
int $minMemorySize = 50
 Minimum memory size in MiB. More...
 
array $objectCaches
 Known object cache types and the functions used to test for their existence. More...
 
ParserOptions $parserOptions
 Cached ParserOptions, used by parse(). More...
 
Title $parserTitle
 Cached Title, used by parse(). More...
 
array $settings
 

Static Protected Attributes

static array $dbTypes
 Known database types. More...
 

Detailed Description

Base installer class.

This class provides the base for installation and update functionality for both MediaWiki core and extensions.

Since
1.17

Definition at line 60 of file Installer.php.

Constructor & Destructor Documentation

◆ __construct()

Installer::__construct ( )

Constructor, always call this from child classes.

Definition at line 407 of file Installer.php.

References $type, doEnvironmentPreps(), getDBInstaller(), getInstallerConfig(), and resetMediaWikiServices().

Member Function Documentation

◆ addInstallStep()

Installer::addInstallStep (   $callback,
  $findStep = 'BEGINNING' 
)

Add an installation step following the given step.

Parameters
array$callbackA valid installation callback array, in this form: [ 'name' => 'some-unique-name', 'callback' => [ $obj, 'function' ] ];
string$findStepThe step to find. Omit to put the step at the beginning

Definition at line 1967 of file Installer.php.

◆ apacheModulePresent()

static Installer::apacheModulePresent (   $moduleName)
static

Checks for presence of an Apache module.

Works only if PHP is running as an Apache module, too.

Parameters
string$moduleNameName of module to check.
Returns
bool

Definition at line 1226 of file Installer.php.

◆ createMainpage()

Installer::createMainpage ( DatabaseInstaller  $installer)
protected

Insert Main Page with default content.

Parameters
DatabaseInstaller$installer
Returns
Status

Definition at line 1870 of file Installer.php.

References $content, $title, EDIT_NEW, StatusValue\newGood(), User\newSystemUser(), and wfMessage().

◆ createSysop()

Installer::createSysop ( )
protected

Create the first user account, grant it sysop, bureaucrat and interface-admin rights.

Returns
Status

Definition at line 1766 of file Installer.php.

References SiteStatsUpdate\factory(), StatusValue\newFatal(), User\newFromName(), and StatusValue\newGood().

◆ dirIsExecutable()

Installer::dirIsExecutable (   $dir,
  $url 
)

Checks if scripts located in the given directory can be executed via the given URL.

Used only by environment checks.

Parameters
string$dir
string$url
Returns
bool|int|string

Reimplemented in CliInstaller.

Definition at line 1171 of file Installer.php.

References $ext, $file, and $source.

◆ disableLinkPopups()

Installer::disableLinkPopups ( )

Definition at line 803 of file Installer.php.

◆ disableTimeLimit()

Installer::disableTimeLimit ( )
protected

Disable the time limit for execution.

Some long-running pages (Install, Upgrade) will want to do this

Definition at line 1975 of file Installer.php.

Referenced by WebInstaller\execute().

◆ doEnvironmentChecks()

Installer::doEnvironmentChecks ( )

Do initial checks of the PHP environment.

Set variables according to the observed environment.

It's possible that this may be called under the CLI SAPI, not the SAPI that the wiki will primarily run under. In that case, the subclass should initialise variables such as wgScriptPath, before calling this function.

It can already be assumed that a supported PHP version is in use. Under the web subclass, it can also be assumed that sessions are working.

Returns
Status

Definition at line 562 of file Installer.php.

References StatusValue\newFatal(), and StatusValue\newGood().

◆ doEnvironmentPreps()

Installer::doEnvironmentPreps ( )

Definition at line 580 of file Installer.php.

Referenced by __construct().

◆ doGenerateKeys()

Installer::doGenerateKeys (   $keys)
protected

Generate a secret value for variables using a secure generator.

Parameters
array$keys
Returns
Status

Definition at line 1753 of file Installer.php.

References $keys, MWCryptRand\generateHex(), and StatusValue\newGood().

◆ envCheck64Bit()

Installer::envCheck64Bit ( )
protected

Checks if we're running on 64 bit or not.

32 bit is becoming increasingly hard to support, so let's at least warn people.

Returns
bool

Definition at line 1122 of file Installer.php.

◆ envCheckCache()

Installer::envCheckCache ( )
protected

Environment check for compiled object cache types.

Definition at line 940 of file Installer.php.

◆ envCheckDB()

Installer::envCheckDB ( )
protected

Environment check for DB types.

Returns
bool

Definition at line 852 of file Installer.php.

References $wgLang, and wfMessage().

◆ envCheckDiff3()

Installer::envCheckDiff3 ( )
protected

Search for GNU diff3.

Returns
bool

Definition at line 972 of file Installer.php.

References ExecutableFinder\findInDefaultPaths(), and wfIsWindows().

◆ envCheckGit()

Installer::envCheckGit ( )
protected

Search for git.

Since
1.22
Returns
bool

Definition at line 1019 of file Installer.php.

References ExecutableFinder\findInDefaultPaths(), and wfIsWindows().

◆ envCheckGraphics()

Installer::envCheckGraphics ( )
protected

Environment check for ImageMagick and GD.

Returns
bool

Definition at line 995 of file Installer.php.

References ExecutableFinder\findInDefaultPaths(), and wfIsWindows().

◆ envCheckLibicu()

Installer::envCheckLibicu ( )
protected

Check and display the libicu and Unicode versions.

Definition at line 1133 of file Installer.php.

◆ envCheckMemory()

Installer::envCheckMemory ( )
protected

Environment check for available memory.

Returns
bool

Definition at line 914 of file Installer.php.

References wfShorthandToInteger().

◆ envCheckModSecurity()

Installer::envCheckModSecurity ( )
protected

Scare user to death if they have mod_security or mod_security2.

Returns
bool

Definition at line 959 of file Installer.php.

◆ envCheckPath()

Installer::envCheckPath ( )
protected

Environment check to inform user which paths we've assumed.

Returns
bool

Reimplemented in WebInstaller, and CliInstaller.

Definition at line 1054 of file Installer.php.

◆ envCheckPCRE()

Installer::envCheckPCRE ( )
protected

Check for known PCRE-related compatibility issues.

Note
We don't bother checking for Unicode support here. If it were missing, the parser would probably throw an exception before the result of this check is shown to the user.
Returns
bool

Definition at line 899 of file Installer.php.

◆ envCheckServer()

Installer::envCheckServer ( )
protected

Environment check to inform user which server we've assumed.

Returns
bool

Definition at line 1041 of file Installer.php.

◆ envCheckUploadsDirectory()

Installer::envCheckUploadsDirectory ( )
protected

Environment check for the permissions of the uploads directory.

Returns
bool

Definition at line 1067 of file Installer.php.

References $IP.

◆ envCheckUploadsServerResponse()

Installer::envCheckUploadsServerResponse ( )
protected

Definition at line 1081 of file Installer.php.

◆ envGetDefaultServer()

Installer::envGetDefaultServer ( )
abstractprotected

Helper function to be called from envPrepServer()

Returns
string

Reimplemented in WebInstaller, and CliInstaller.

◆ envPrepPath()

Installer::envPrepPath ( )
protected

Environment prep for setting $IP and $wgScriptPath.

Reimplemented in WebInstaller.

Definition at line 1157 of file Installer.php.

References $IP.

◆ envPrepServer()

Installer::envPrepServer ( )
protected

Environment prep for the server hostname.

Definition at line 1141 of file Installer.php.

◆ findExtensions()

Installer::findExtensions (   $directory = 'extensions')

Find extensions or skins in a subdirectory of $IP.

Returns an array containing the value for 'Name' for each found extension.

Parameters
string$directoryDirectory to search in, relative to $IP, must be either "extensions" or "skins"
Returns
Status An object containing an error list. If there were no errors, an associative array of information about the extension can be found in $status->value.

Definition at line 1266 of file Installer.php.

Referenced by CliInstaller\__construct().

◆ findExtensionsByType()

Installer::findExtensionsByType (   $type = 'extension',
  $directory = 'extensions' 
)
protected

Find extensions or skins, and return an array containing the value for 'Name' for each found extension.

Parameters
string$typeEither "extension" or "skin"
string$directoryDirectory to search in, relative to $IP
Returns
Status An object containing an error list. If there were no errors, an associative array of information about the extension can be found in $status->value.

Definition at line 1286 of file Installer.php.

References $file, $type, and StatusValue\newGood().

◆ generateKeys()

Installer::generateKeys ( )

Generate $wgSecretKey.

Will warn if we had to use an insecure random source.

Returns
Status

Definition at line 1725 of file Installer.php.

References $keys.

◆ getAutoExtensionData()

Installer::getAutoExtensionData ( )
protected

Auto-detect extensions with an extension.json file.

Load the extensions, register classes with the autoloader and return the merged registry data.

Returns
array

Definition at line 1582 of file Installer.php.

◆ getAutoExtensionHookContainer()

Installer::getAutoExtensionHookContainer ( )

Get the hook container previously populated by includeExtensions().

Access: internal
For use by DatabaseInstaller
Since
1.36
Returns
HookContainer

Definition at line 1609 of file Installer.php.

◆ getAutoExtensionLegacyHooks()

Installer::getAutoExtensionLegacyHooks ( )
protected

Auto-detect extensions with an old style .php registration file, load the extensions, and return the merged $wgHooks array.

Returns
array

Definition at line 1515 of file Installer.php.

◆ getCompiledDBs()

Installer::getCompiledDBs ( )

Get a list of DBs supported by current PHP setup.

Returns
array

Definition at line 615 of file Installer.php.

◆ getDBInstaller()

Installer::getDBInstaller (   $type = false)

Get an instance of DatabaseInstaller for the specified DB type.

Parameters
mixed$typeDB installer for which is needed, false to use default.
Returns
DatabaseInstaller

Definition at line 637 of file Installer.php.

References $type.

Referenced by __construct(), and LocalSettingsGenerator\__construct().

◆ getDBInstallerClass()

static Installer::getDBInstallerClass (   $type)
static

Get the DatabaseInstaller class name for this type.

Parameters
string$typedatabase type ($wgDBtype)
Returns
string Class name
Since
1.30

Definition at line 626 of file Installer.php.

References $type.

Referenced by UpdateMediaWiki\execute().

◆ getDBTypes()

static Installer::getDBTypes ( )
static

Get a list of known DB types.

Returns
array

Definition at line 545 of file Installer.php.

Referenced by WebInstallerDBConnect\execute(), WebInstallerExistingWiki\handleExistingUpgrade(), and DatabaseUpdater\newForDB().

◆ getDefaultSkin()

Installer::getDefaultSkin ( array  $skinNames)

Returns a default value to be used for $wgDefaultSkin: normally the DefaultSkin from config-schema.yaml, but will fall back to another if the default skin is missing and some other one is present instead.

Parameters
string[]$skinNamesNames of installed skins.
Returns
string

Definition at line 1466 of file Installer.php.

Referenced by CliInstaller\__construct().

◆ getDocUrl()

Installer::getDocUrl (   $page)
protected

Overridden by WebInstaller to provide lastPage parameters.

Parameters
string$page
Returns
string

Reimplemented in WebInstaller.

Definition at line 1253 of file Installer.php.

◆ getExistingLocalSettings()

static Installer::getExistingLocalSettings ( )
static

Determine if LocalSettings.php exists.

If it does, return its variables.

Returns
array|false

Definition at line 657 of file Installer.php.

References $IP, $wgAutoloadClasses, $wgExtensionDirectory, $wgStyleDirectory, wfDetectInstallPath(), and wfDetectLocalSettingsFile().

Referenced by CliInstaller\execute(), and WebInstallerExistingWiki\execute().

◆ getExtensionInfo()

Installer::getExtensionInfo (   $type,
  $parentRelPath,
  $name 
)
protected
Parameters
string$typeEither "extension" or "skin"
string$parentRelPathThe parent directory relative to $IP
string$nameThe extension or skin name
Returns
Status An object containing an error list. If there were no errors, an associative array of information about the extension can be found in $status->value.

Definition at line 1329 of file Installer.php.

References $path, $type, StatusValue\newFatal(), and StatusValue\newGood().

◆ getFakePassword()

Installer::getFakePassword (   $realPassword)

Get a fake password for sending back to the user in HTML.

This is a security mechanism to avoid compromise of the password in the event of session ID compromise.

Parameters
string$realPassword
Returns
string

Definition at line 723 of file Installer.php.

Referenced by WebInstaller\getPasswordBox().

◆ getInstallerConfig()

static Installer::getInstallerConfig ( Config  $baseConfig)
static

Constructs a Config object that contains configuration settings that should be overwritten for the installation process.

Since
1.27
Parameters
Config$baseConfig
Returns
Config The config to use during installation.

Definition at line 369 of file Installer.php.

References $objectCaches, CACHE_ANYTHING, CACHE_DB, CACHE_MEMCACHED, CACHE_NONE, and Config\get().

Referenced by __construct().

◆ getInstallSteps()

Installer::getInstallSteps ( DatabaseInstaller  $installer)
protected

Get an array of install steps.

Should always be in the format of [ 'name' => 'someuniquename', 'callback' => [ $obj, 'method' ], ] There must be a config-install-$name message defined per step, which will be shown on install.

Parameters
DatabaseInstaller$installerDatabaseInstaller so we can make callbacks
Returns
array[]

Definition at line 1630 of file Installer.php.

◆ getParserOptions()

Installer::getParserOptions ( )
Returns
ParserOptions

Definition at line 799 of file Installer.php.

◆ getVar()

Installer::getVar (   $name,
  $default = null 
)

Get an MW configuration variable, or internal installer configuration variable.

The defaults come from MainConfigSchema. Installer variables are typically prefixed by an underscore.

Parameters
string$name
mixed | null$default
Returns
mixed

Definition at line 606 of file Installer.php.

Referenced by CliInstaller\__construct(), LocalSettingsGenerator\__construct(), CliInstaller\envCheckPath(), WebInstaller\envGetDefaultServer(), CliInstaller\execute(), WebInstaller\execute(), WebInstaller\getCheckBox(), WebInstaller\getPasswordBox(), WebInstaller\getRadioElements(), WebInstaller\getTextArea(), WebInstaller\getTextBox(), and WebInstaller\setupLanguage().

◆ includeExtensionFiles()

Installer::includeExtensionFiles (   $files)
protected

Include the specified extension PHP files.

Populate $wgAutoloadClasses and return the LoadExtensionSchemaUpdates hooks.

Parameters
string[]$files
Returns
array LoadExtensionSchemaUpdates legacy hooks

Definition at line 1539 of file Installer.php.

References $file, $IP, $wgAutoloadClasses, $wgExtensionDirectory, $wgHooks, and $wgStyleDirectory.

◆ includeExtensions()

Installer::includeExtensions ( )
protected

Installs the auto-detected extensions.

Returns
Status

Definition at line 1483 of file Installer.php.

References StatusValue\newGood().

◆ maybeGetWebserverPrimaryGroup()

static Installer::maybeGetWebserverPrimaryGroup ( )
static

On POSIX systems return the primary group of the webserver we're running under.

On other systems just returns null.

This is used to advice the user that he should chgrp his mw-config/data/images directory as the webserver user before he can install.

Public because SqliteInstaller needs it, and doesn't subclass Installer.

Returns
mixed

Definition at line 751 of file Installer.php.

◆ overrideConfig()

static Installer::overrideConfig ( SettingsBuilder  $settings)
static

Override the necessary bits of the config to run an installation.

Parameters
SettingsBuilder$settings

Definition at line 1903 of file Installer.php.

References CACHE_NONE, and MediaWiki\Settings\SettingsBuilder\overrideConfigValues().

Referenced by CommandLineInstaller\finalSetup().

◆ parse()

Installer::parse (   $text,
  $lineStart = false 
)

Convert wikitext $text to HTML.

This is potentially error prone since many parser features require a complete installed MW database. The solution is to just not use those features when you write your messages. This appears to work well enough. Basic formatting and external links work just fine.

But in case a translator decides to throw in a "#ifexist" or internal link or whatever, this function is guarded to catch the attempted DB access and to present some fallback text.

Parameters
string$text
bool$lineStart
Returns
string

Definition at line 779 of file Installer.php.

References Parser\stripOuterParagraph().

Referenced by WebInstaller\getCheckBox(), WebInstaller\getHelpBox(), WebInstaller\getInfoBox(), WebInstaller\getRadioElements(), WebInstaller\makeDownloadLinkHtml(), and WebInstaller\showMessage().

◆ performInstallation()

Installer::performInstallation (   $startCB,
  $endCB 
)

Actually perform the installation.

Parameters
callable$startCBA callback array for the beginning of each step
callable$endCBA callback array for the end of each step
Returns
Status[]

Definition at line 1686 of file Installer.php.

Referenced by CliInstaller\execute().

◆ populateSiteStats()

Installer::populateSiteStats ( DatabaseInstaller  $installer)

Install step which adds a row to the site_stats table with appropriate initial values.

Parameters
DatabaseInstaller$installer
Returns
Status

Definition at line 824 of file Installer.php.

References DatabaseInstaller\getConnection(), and StatusValue\newGood().

◆ resetMediaWikiServices()

Installer::resetMediaWikiServices ( Config  $installerConfig = null,
  $serviceOverrides = [],
bool  $disableStorage = false 
)

Reset the global service container and associated global state to accommodate different stages of the installation.

Since
1.35
Parameters
Config | null$installerConfigConfig override. If null, the previous config will be inherited.
array$serviceOverridesService definition overrides. Values can be null to disable specific overrides that would be applied per default, namely 'InterwikiLookup' and 'UserOptionsLookup'.
bool$disableStorageWhether MediaWikiServices::disableStorage() should be called.
Returns
MediaWikiServices

Definition at line 465 of file Installer.php.

References $lang, $wgLang, $wgObjectCaches, RequestContext\getMain(), and User\newFromId().

Referenced by __construct().

◆ restoreLinkPopups()

Installer::restoreLinkPopups ( )

Definition at line 809 of file Installer.php.

References $wgExternalLinkTarget.

◆ restoreServices()

Installer::restoreServices ( )

Restore services that have been redefined in the early stage of installation.

Returns
Status

Definition at line 1738 of file Installer.php.

References StatusValue\newGood().

◆ setParserLanguage()

Installer::setParserLanguage (   $lang)

ParserOptions are constructed before we determined the language, so fix it.

Parameters
Language$lang

Definition at line 1243 of file Installer.php.

References $lang.

◆ setPassword()

Installer::setPassword (   $name,
  $value 
)

Set a variable which stores a password, except if the new value is a fake password in which case leave it as it is.

Parameters
string$name
mixed$value

Definition at line 734 of file Installer.php.

Referenced by WebInstaller\setVarsFromRequest().

◆ setVar()

Installer::setVar (   $name,
  $value 
)

Set a MW configuration variable, or internal installer configuration variable.

Parameters
string$name
mixed$value

Definition at line 592 of file Installer.php.

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

◆ showError()

Installer::showError (   $msg,
  $params 
)
abstract

Same as showMessage(), but for displaying errors.

Parameters
string$msg
mixed...$params

Reimplemented in WebInstaller, and CliInstaller.

◆ showMessage()

Installer::showMessage (   $msg,
  $params 
)
abstract

UI interface for displaying a short message The parameters are like parameters to wfMessage().

The messages will be in wikitext format, which will be converted to an output format such as HTML or text before being sent to the user.

Parameters
string$msg
mixed...$params

Reimplemented in WebInstaller, and CliInstaller.

◆ showStatusMessage()

Installer::showStatusMessage ( Status  $status)
abstract

Show a message to the installing user by using a Status object.

Parameters
Status$status

Reimplemented in WebInstaller, and CliInstaller.

Member Data Documentation

◆ $autoExtensionHookContainer

HookContainer null Installer::$autoExtensionHookContainer
protected

Definition at line 334 of file Installer.php.

◆ $compiledDBs

array Installer::$compiledDBs
protected

List of detected DBs, access using getCompiledDBs().

Definition at line 78 of file Installer.php.

◆ $dbInstallers

array Installer::$dbInstallers = []
protected

Cached DB installer instances, access using getDBInstaller().

Definition at line 85 of file Installer.php.

◆ $dbTypes

array Installer::$dbTypes
staticprotected
Initial value:
= [
'mysql',
'postgres',
'sqlite',
]

Known database types.

These correspond to the class names <type>Installer, and are also MediaWiki database types valid for $wgDBtype.

To add a new type, create a <type>Installer class and a Database<type> class, and add a config-type-<type> message to MessagesEn.php.

Definition at line 117 of file Installer.php.

◆ $envChecks

array Installer::$envChecks
protected
Initial value:
= [
'envCheckLibicu',
'envCheckDB',
'envCheckPCRE',
'envCheckMemory',
'envCheckCache',
'envCheckModSecurity',
'envCheckDiff3',
'envCheckGraphics',
'envCheckGit',
'envCheckServer',
'envCheckPath',
'envCheckUploadsDirectory',
'envCheckUploadsServerResponse',
'envCheck64Bit',
]

A list of environment check methods called by doEnvironmentChecks().

These may output warnings using showMessage(), and/or abort the installation process by returning false.

For the WebInstaller these are only called on the Welcome page, if these methods have side-effects that should affect later page loads (as well as the generated stylesheet), use envPreps instead.

Definition at line 134 of file Installer.php.

◆ $envPreps

array Installer::$envPreps
protected
Initial value:
= [
'envPrepServer',
'envPrepPath',
]

A list of environment preparation methods called by doEnvironmentPreps().

Definition at line 156 of file Installer.php.

◆ $extraInstallSteps

array Installer::$extraInstallSteps = []
protected

Extra steps for installation, for things like DatabaseInstallers to modify.

Definition at line 255 of file Installer.php.

◆ $internalDefaults

array Installer::$internalDefaults
protected

Variables that are stored alongside globals, and are used for any configuration of the installation process aside from the MediaWiki configuration.

Map of names to defaults.

Definition at line 204 of file Installer.php.

◆ $licenses

array Installer::$licenses

License types.

Definition at line 297 of file Installer.php.

◆ $minMemorySize

int Installer::$minMemorySize = 50
protected

Minimum memory size in MiB.

Definition at line 92 of file Installer.php.

◆ $objectCaches

array Installer::$objectCaches
protected
Initial value:
= [
'apcu' => 'apcu_fetch',
'wincache' => 'wincache_ucache_get'
]

Known object cache types and the functions used to test for their existence.

Definition at line 262 of file Installer.php.

Referenced by getInstallerConfig().

◆ $parserOptions

ParserOptions Installer::$parserOptions
protected

Cached ParserOptions, used by parse().

Definition at line 106 of file Installer.php.

◆ $parserTitle

Title Installer::$parserTitle
protected

Cached Title, used by parse().

Definition at line 99 of file Installer.php.

◆ $rightsProfiles

array Installer::$rightsProfiles
Initial value:
= [
'wiki' => [],
'no-anon' => [
'*' => [ 'edit' => false ]
],
'fishbowl' => [
'*' => [
'createaccount' => false,
'edit' => false,
],
],
'private' => [
'*' => [
'createaccount' => false,
'edit' => false,
'read' => false,
],
],
]

User rights profiles.

Definition at line 272 of file Installer.php.

◆ $settings

array Installer::$settings
protected

Definition at line 71 of file Installer.php.

Referenced by WebInstaller\execute(), and WebInstaller\finish().


The documentation for this class was generated from the following file: