Class for the core installer web interface. More...

Collaboration diagram for MediaWiki\Installer\WebInstaller:

[legend]

Public Member Functions
	__construct (WebRequest $request)

	doUpgrade ()
	Perform database upgrades.

	envCheckPath ()

	errorHandler ( $errno, $errstr)
	Temporary error handler for session start debugging.

	execute (array $session)
	Main entry point.

	finish ()
	Clean up from execute()

	getAcceptLanguage ()
	Retrieves MediaWiki language from Accept-Language HTTP header.

	getCheckBox ( $params)
	Get a labelled checkbox to configure a boolean variable.

	getDefaultServer ()

	getDocUrl ( $page)
	Helper for WebInstallerOutput.

	getFingerprint ()
	Get a hash of data identifying this MW installation.

	getHelpBox ( $msg,... $params)
	Get small text indented help for a preceding form field.

	getInfoBox ( $text)
	Get HTML for an information message box.

	getLocalSettingsLocation ()
	If the software package wants the LocalSettings.php file to be placed in a specific location, override this function (see mw-config/overrides/README) to return the path of where the file should be saved, or false for a generic "in the base of your install".

	getLowestUnhappy ()
	Find the next page in sequence that hasn't been completed.

	getPageByName ( $pageName)
	Get a WebInstallerPage by name.

	getPasswordBox ( $params)
	Get a labelled password box to configure a variable.

	getPhpErrors ()

	getRadioElements ( $params)
	Get a set of labelled radio buttons.

	getRadioSet ( $params)
	Get a set of labelled radio buttons.

	getSession ( $name, $default=null)
	Get a session variable.

	getTextArea ( $params)
	Get a labelled textarea to configure a variable.

	getTextBox ( $params)
	Get a labelled text box to configure a variable.

	getUrl ( $query=[])
	Get a URL for submission back to the same script.

	label ( $msg, $forId, $contents, $helpData="")
	Label a control by wrapping a config-input div around it and putting a label before it.

	makeLinkItem ( $url, $linkText)
	Helper for sidebar links.

	needsUpgrade ()
	Determine whether the current database needs to be upgraded, i.e.

	nextTabIndex ()
	Get the next tabindex attribute value.

	outputCss ()
	Output stylesheet for web installer pages.

	outputHandler ( $string)

	reset ()
	We're restarting the installation, reset the session, happyPages, etc.

	setSession ( $name, $value)
	Set a session variable.

	setupLanguage ()
	Initializes language-related variables.

	setVarsFromRequest ( $varNames, $prefix='config_')
	Convenience function to set variables based on form data.

	showError ( $msg,... $params)
	Display an error message.

	showMessage ( $msg,... $params)
	Display a short neutral message.

	showStatusBox ( $status)
	Output an error or warning box using a Status object.

	showStatusMessage (Status $status)
	Show a message to the installing user by using a Status object.

	showSuccess ( $msg,... $params)
	Display a success message.

	showWarning ( $msg,... $params)
	Display a warning message.

	startSession ()
	Start the PHP session.

Public Member Functions inherited from MediaWiki\Installer\Installer
	__construct ()
	Constructor, always call this from child classes.

	addInstallStep ( $callback, $findStep='BEGINNING')
	Add an installation step following the given step.

	dirIsExecutable ( $dir, $url)
	Checks if scripts located in the given directory can be executed via the given URL.

	disableLinkPopups ()

	doEnvironmentChecks ()
	Do initial checks of the PHP environment.

	findExtensions ( $directory='extensions')
	Find extensions or skins in a subdirectory of $IP.

	getCompiledDBs ()
	Get a list of DBs supported by current PHP setup.

	getDBInstaller ( $type=false)
	Get an instance of DatabaseInstaller for the specified DB type.

	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.

	getFakePassword ( $realPassword)
	Get a fake password for sending back to the user in HTML.

	getParserOptions ()

	getVar ( $name, $default=null)
	Get an MW configuration variable, or internal installer configuration variable.

	parse ( $text, $lineStart=false)
	Convert wikitext $text to HTML.

	performInstallation ( $startCB, $endCB)
	Actually perform the installation.

	restoreLinkPopups ()

	setParserLanguage ( $lang)
	ParserOptions are constructed before we determined the language, so fix it.

	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.

	setVar ( $name, $value)
	Set a MW configuration variable, or internal installer configuration variable.

Public Attributes
WebInstallerOutput	$output

string[]	$pageSequence
	The main sequence of page names.

WebRequest	$request
	WebRequest object.

bool	$showSessionWarning = false
	Flag indicating that session data may have been lost.

Public Attributes inherited from MediaWiki\Installer\Installer
array	$licenses
	License types.

array	$rightsProfiles
	User rights profiles.

Protected Member Functions
	detectWebPaths ()
	This is overridden by the web installer to provide the detected wgScriptPath.

	envGetDefaultServer ()

Protected Member Functions inherited from MediaWiki\Installer\Installer
	disableTimeLimit ()
	Disable the time limit for execution.

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

	envCheckCache ()
	Environment check for compiled object cache types.

	envCheckDB ()
	Environment check for DB types.

	envCheckDiff3 ()
	Search for GNU diff3.

	envCheckGit ()
	Search for git.

	envCheckGraphics ()
	Environment check for ImageMagick and GD.

	envCheckLibicu ()
	Check and display the libicu and Unicode versions.

	envCheckMemory ()
	Environment check for available memory.

	envCheckModSecurity ()
	Scare user to death if they have mod_security or mod_security2.

	envCheckPCRE ()
	Check for known PCRE-related compatibility issues.

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

	envCheckUploadsDirectory ()
	Environment check for the permissions of the uploads directory.

	envCheckUploadsServerResponse ()

	findExtensionsByType ( $type='extension', $directory='extensions')
	Find extensions or skins, and return an array containing the value for 'Name' for each found extension.

	getDefaultSettingsOverrides ()
	Override this in a subclass to override the default settings.

	getExtensionInfo ( $type, $parentRelPath, $name)

	getTaskFactory ()

	getTaskList ()
	Get a list of tasks to do.

Protected Attributes
string	$currentPageName
	Name of the page we're on.

bool[]	$happyPages
	Array of pages which have declared that they have been submitted, have validated their input, and need no further processing.

int	$helpBoxId = 1
	Numeric index of the help box.

string[]	$otherPages
	Out of sequence pages, selectable by the user at any time.

string[]	$phpErrors
	Captured PHP error text.

array[]	$session
	Cached session array.

bool[]	$skippedPages
	List of "skipped" pages.

int	$tabIndex = 1
	Numeric index of the page we're on.

Protected Attributes inherited from MediaWiki\Installer\Installer
HookContainer null	$autoExtensionHookContainer

array	$compiledDBs
	List of detected DBs, access using getCompiledDBs().

array	$dbInstallers = []
	Cached DB installer instances, access using getDBInstaller().

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

array	$extraInstallSteps = []
	Extra steps for installation, for things like DatabaseInstallers to modify.

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

int	$minMemorySize = 50
	Minimum memory size in MiB.

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

ParserOptions	$parserOptions
	Cached ParserOptions, used by parse().

Title	$parserTitle
	Cached Title, used by parse().

array	$settings

array	$virtualDomains = []

Additional Inherited Members
Static Public Member Functions inherited from MediaWiki\Installer\Installer
static	apacheModulePresent ( $moduleName)
	Checks for presence of an Apache module.

static	disableStorage (Config $config, string $lang)
	Reset the global service container and associated global state, disabling storage, to support pre-installation operation.

static	getDBInstallerClass ( $type)
	Get the DatabaseInstaller class name for this type.

static	getDBTypes ()
	Get a list of known DB types.

static	getExistingLocalSettings ()
	Determine if LocalSettings.php exists.

static	getInstallerConfig (Config $baseConfig)
	Constructs a Config object that contains configuration settings that should be overwritten for the installation process.

static	overrideConfig (SettingsBuilder $settings)
	Override the necessary bits of the config to run an installation.

Static Protected Attributes inherited from MediaWiki\Installer\Installer
static array	$dbTypes
	Known database types.

Detailed Description

Class for the core installer web interface.

Since: 1.17

Definition at line 45 of file WebInstaller.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Installer\WebInstaller::__construct ( WebRequest $request )

Definition at line 153 of file WebInstaller.php.

References MediaWiki\Installer\WebInstaller\$request.

Member Function Documentation

◆ detectWebPaths()

MediaWiki\Installer\WebInstaller::detectWebPaths ( )

protected

This is overridden by the web installer to provide the detected wgScriptPath.

Returns: array

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 1149 of file WebInstaller.php.

References $path.

◆ doUpgrade()

MediaWiki\Installer\WebInstaller::doUpgrade ( )

Perform database upgrades.

Returns: bool

Definition at line 1241 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getDBInstaller(), MediaWiki\Installer\Installer\getTaskFactory(), and MediaWiki\Installer\Installer\setVar().

◆ envCheckPath()

MediaWiki\Installer\WebInstaller::envCheckPath ( )

Returns: bool

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 1131 of file WebInstaller.php.

References $path, and MediaWiki\Installer\WebInstaller\showError().

◆ envGetDefaultServer()

MediaWiki\Installer\WebInstaller::envGetDefaultServer ( )

protected

Returns: string

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 1180 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getVar().

Referenced by MediaWiki\Installer\WebInstaller\getDefaultServer().

◆ errorHandler()

MediaWiki\Installer\WebInstaller::errorHandler	(		$errno,
			$errstr )

Temporary error handler for session start debugging.

Parameters

int	$errno	Unused
string	$errstr

Definition at line 389 of file WebInstaller.php.

◆ execute()

MediaWiki\Installer\WebInstaller::execute ( array $session )

Main entry point.

Parameters

array[] $session Initial session array

Returns: array[] New session array

Definition at line 166 of file WebInstaller.php.

References MediaWiki\Installer\WebInstaller\$session, MediaWiki\Installer\Installer\$settings, MediaWiki\Installer\Installer\disableTimeLimit(), MediaWiki\Installer\WebInstaller\finish(), MediaWiki\Installer\WebInstaller\getLowestUnhappy(), MediaWiki\Installer\WebInstaller\getPageByName(), MediaWiki\Installer\WebInstaller\getUrl(), MediaWiki\Installer\Installer\getVar(), MediaWiki\Installer\WebInstaller\outputCss(), and MediaWiki\Installer\WebInstaller\setupLanguage().

◆ finish()

MediaWiki\Installer\WebInstaller::finish ( )

Clean up from execute()

Returns: array[]

Definition at line 398 of file WebInstaller.php.

References MediaWiki\Installer\WebInstaller\$happyPages, MediaWiki\Installer\WebInstaller\$session, MediaWiki\Installer\Installer\$settings, and MediaWiki\Installer\WebInstaller\$skippedPages.

Referenced by MediaWiki\Installer\WebInstaller\execute().

◆ getAcceptLanguage()

MediaWiki\Installer\WebInstaller::getAcceptLanguage ( )

Retrieves MediaWiki language from Accept-Language HTTP header.

Returns: string

Definition at line 503 of file WebInstaller.php.

References $wgLanguageCode, and MediaWiki\MediaWikiServices\getInstance().

Referenced by MediaWiki\Installer\WebInstaller\setupLanguage().

◆ getCheckBox()

MediaWiki\Installer\WebInstaller::getCheckBox ( $params )

Get a labelled checkbox to configure a boolean variable.

Parameters

mixed[] $params Parameters are: var: The variable to be configured (required) label: The message name for the label (required) labelAttribs:Additional attributes for the label element (optional) attribs: Additional attributes for the input element (optional) controlName: The name for the input element (optional) value: The current value of the variable (optional) help: The html for the help text (optional)

Returns: string HTML

Definition at line 886 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getVar(), MediaWiki\Installer\WebInstaller\nextTabIndex(), MediaWiki\Installer\Installer\parse(), and wfMessage().

◆ getDefaultServer()

MediaWiki\Installer\WebInstaller::getDefaultServer ( )

Returns: string

Definition at line 1190 of file WebInstaller.php.

References MediaWiki\Installer\WebInstaller\envGetDefaultServer().

◆ getDocUrl()

MediaWiki\Installer\WebInstaller::getDocUrl ( $page )

Helper for WebInstallerOutput.

Access: internal: For use by WebInstallerOutput

Parameters

string $page

Returns: string

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 1090 of file WebInstaller.php.

References MediaWiki\Installer\WebInstaller\$currentPageName, and MediaWiki\Installer\WebInstaller\getUrl().

◆ getFingerprint()

MediaWiki\Installer\WebInstaller::getFingerprint ( )

Get a hash of data identifying this MW installation.

This is used by mw-config/index.php to prevent multiple installations of MW on the same cookie domain from interfering with each other.

Returns: string

Definition at line 351 of file WebInstaller.php.

References $url, and MW_VERSION.

◆ getHelpBox()

MediaWiki\Installer\WebInstaller::getHelpBox	(		$msg,
			$params )

Get small text indented help for a preceding form field.

Parameters like wfMessage().

Parameters

string	$msg	Message key
	string\|int\|float	...$params Message parameters

Returns: string HTML

Definition at line 637 of file WebInstaller.php.

References MediaWiki\Installer\Installer\parse(), and wfMessage().

◆ getInfoBox()

MediaWiki\Installer\WebInstaller::getInfoBox ( $text )

Get HTML for an information message box.

Parameters

string | HtmlArmor $text Wikitext to be parsed (from Message::plain) or raw HTML.

Returns: string HTML

Definition at line 658 of file WebInstaller.php.

References MediaWiki\Installer\Installer\parse(), and wfMessage().

◆ getLocalSettingsLocation()

MediaWiki\Installer\WebInstaller::getLocalSettingsLocation ( )

If the software package wants the LocalSettings.php file to be placed in a specific location, override this function (see mw-config/overrides/README) to return the path of where the file should be saved, or false for a generic "in the base of your install".

Since: 1.27

Returns: string|bool

Definition at line 1124 of file WebInstaller.php.

◆ getLowestUnhappy()

MediaWiki\Installer\WebInstaller::getLowestUnhappy ( )

Find the next page in sequence that hasn't been completed.

Returns: int

Definition at line 299 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\execute().

◆ getPageByName()

MediaWiki\Installer\WebInstaller::getPageByName ( $pageName )

Get a WebInstallerPage by name.

Parameters

string $pageName

Returns: WebInstallerPage

Definition at line 442 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\execute().

◆ getPasswordBox()

MediaWiki\Installer\WebInstaller::getPasswordBox ( $params )

Get a labelled password box to configure a variable.

Implements password hiding

Parameters

mixed[] $params Parameters are: var: The variable to be configured (required) label: The message name for the label (required) attribs: Additional attributes for the input element (optional) controlName: The name for the input element (optional) value: The current value of the variable (optional) help: The html for the help text (optional)

Returns: string HTML

Definition at line 855 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getFakePassword(), MediaWiki\Installer\WebInstaller\getTextBox(), and MediaWiki\Installer\Installer\getVar().

◆ getPhpErrors()

MediaWiki\Installer\WebInstaller::getPhpErrors ( )

Returns: string[]

Definition at line 1222 of file WebInstaller.php.

References MediaWiki\Installer\WebInstaller\$phpErrors.

◆ getRadioElements()

MediaWiki\Installer\WebInstaller::getRadioElements ( $params )

Get a set of labelled radio buttons.

You probably want to use getRadioSet(), not this.

See also: getRadioSet

Parameters

mixed[] $params

Returns: string[] HTML

Definition at line 981 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getVar(), MediaWiki\Installer\WebInstaller\nextTabIndex(), MediaWiki\Installer\Installer\parse(), and wfMessage().

Referenced by MediaWiki\Installer\WebInstaller\getRadioSet().

◆ getRadioSet()

MediaWiki\Installer\WebInstaller::getRadioSet ( $params )

Get a set of labelled radio buttons.

Parameters

mixed[] $params Parameters are: var: The variable to be configured (required) label: The message name for the label (required) itemLabelPrefix: The message name prefix for the item labels (required) itemLabels: List of message names to use for the item labels instead of itemLabelPrefix, keyed by values values: List of allowed values (required) itemAttribs: Array of attribute arrays, outer key is the value name (optional) commonAttribs: Attribute array applied to all items controlName: The name for the input element (optional) value: The current value of the variable (optional) help: The html for the help text (optional)

Returns: string HTML

Definition at line 951 of file WebInstaller.php.

References MediaWiki\Installer\WebInstaller\getRadioElements(), and MediaWiki\Installer\WebInstaller\label().

◆ getSession()

MediaWiki\Installer\WebInstaller::getSession	(		$name,
			$default = null )

Get a session variable.

Parameters

string	$name
array \| null	$default

Returns: array|null

Definition at line 456 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\setupLanguage().

◆ getTextArea()

MediaWiki\Installer\WebInstaller::getTextArea ( $params )

Get a labelled textarea to configure a variable.

Parameters

mixed[] $params Parameters are: var: The variable to be configured (required) label: The message name for the label (required) attribs: Additional attributes for the input element (optional) controlName: The name for the input element (optional) value: The current value of the variable (optional) help: The html for the help text (optional)

Returns: string

Definition at line 805 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getVar(), MediaWiki\Installer\WebInstaller\label(), and MediaWiki\Installer\WebInstaller\nextTabIndex().

◆ getTextBox()

MediaWiki\Installer\WebInstaller::getTextBox ( $params )

Get a labelled text box to configure a variable.

Parameters

mixed[] $params Parameters are: var: The variable to be configured (required) label: The message name for the label (required) attribs: Additional attributes for the input element (optional) controlName: The name for the input element (optional) value: The current value of the variable (optional) help: The html for the help text (optional)

Returns: string HTML

Definition at line 756 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getVar(), MediaWiki\Installer\WebInstaller\label(), and MediaWiki\Installer\WebInstaller\nextTabIndex().

Referenced by MediaWiki\Installer\WebInstaller\getPasswordBox().

◆ getUrl()

MediaWiki\Installer\WebInstaller::getUrl ( $query = [] )

Get a URL for submission back to the same script.

Parameters

string[] $query

Returns: string

Definition at line 424 of file WebInstaller.php.

References $url, and wfArrayToCgi().

Referenced by MediaWiki\Installer\WebInstaller\execute(), and MediaWiki\Installer\WebInstaller\getDocUrl().

◆ label()

MediaWiki\Installer\WebInstaller::label	(	$msg,
		$forId,
		$contents,
		$helpData = "" )

Label a control by wrapping a config-input div around it and putting a label before it.

Parameters

string	$msg
string \| false	$forId
string	$contents	HTML
string	$helpData

Returns: string HTML

Definition at line 714 of file WebInstaller.php.

References wfMessage().

Referenced by MediaWiki\Installer\WebInstaller\getRadioSet(), MediaWiki\Installer\WebInstaller\getTextArea(), and MediaWiki\Installer\WebInstaller\getTextBox().

◆ makeLinkItem()

MediaWiki\Installer\WebInstaller::makeLinkItem	(		$url,
			$linkText )

Helper for sidebar links.

Access: internal: For use in WebInstallerOutput class

Parameters

string	$url
string	$linkText

Returns: string HTML

Definition at line 1108 of file WebInstaller.php.

References $url, and MediaWiki\Html\element().

◆ needsUpgrade()

MediaWiki\Installer\WebInstaller::needsUpgrade ( )

Determine whether the current database needs to be upgraded, i.e.

whether it already has MediaWiki tables.

Returns: bool

Definition at line 1232 of file WebInstaller.php.

References MediaWiki\Installer\Installer\getDBInstaller().

◆ nextTabIndex()

MediaWiki\Installer\WebInstaller::nextTabIndex ( )

Get the next tabindex attribute value.

Returns: int

Definition at line 475 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\getCheckBox(), MediaWiki\Installer\WebInstaller\getRadioElements(), MediaWiki\Installer\WebInstaller\getTextArea(), and MediaWiki\Installer\WebInstaller\getTextBox().

◆ outputCss()

MediaWiki\Installer\WebInstaller::outputCss ( )

Output stylesheet for web installer pages.

Definition at line 1214 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\execute().

◆ outputHandler()

MediaWiki\Installer\WebInstaller::outputHandler ( $string )

Definition at line 1267 of file WebInstaller.php.

◆ reset()

MediaWiki\Installer\WebInstaller::reset ( )

We're restarting the installation, reset the session, happyPages, etc.

Definition at line 411 of file WebInstaller.php.

◆ setSession()

MediaWiki\Installer\WebInstaller::setSession	(		$name,
			$value )

Set a session variable.

Parameters

string	$name	Key for the variable
mixed	$value

Definition at line 466 of file WebInstaller.php.

◆ setupLanguage()

MediaWiki\Installer\WebInstaller::setupLanguage ( )

Initializes language-related variables.

Definition at line 482 of file WebInstaller.php.

References $wgLang, $wgLanguageCode, MediaWiki\Installer\WebInstaller\getAcceptLanguage(), MediaWiki\MediaWikiServices\getInstance(), MediaWiki\Installer\WebInstaller\getSession(), MediaWiki\Installer\Installer\getVar(), and MediaWiki\Installer\Installer\setVar().

Referenced by MediaWiki\Installer\WebInstaller\execute().

◆ setVarsFromRequest()

MediaWiki\Installer\WebInstaller::setVarsFromRequest	(		$varNames,
			$prefix = 'config_' )

Convenience function to set variables based on form data.

Assumes that variables containing "password" in the name are (potentially fake) passwords.

Parameters

string[]	$varNames
string	$prefix	The prefix added to variables to obtain form names

Returns: string[]

Definition at line 1059 of file WebInstaller.php.

References MediaWiki\Installer\Installer\setPassword(), and MediaWiki\Installer\Installer\setVar().

◆ showError()

MediaWiki\Installer\WebInstaller::showError	(		$msg,
			$params )

Display an error message.

Avoid error fatigue in the installer. Use this only if something the user expects has failed and requires intervention to continue. If something non-essential failed that can be continued past with no action, use a warning instead.

Parameters

string \| MessageSpecifier	$msg
	string\|int\|float	...$params Message parameters

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 371 of file WebInstaller.php.

References wfMessage().

Referenced by MediaWiki\Installer\WebInstaller\envCheckPath().

◆ showMessage()

MediaWiki\Installer\WebInstaller::showMessage	(		$msg,
			$params )

Display a short neutral message.

Parameters

string \| MessageSpecifier	$msg	String of wikitext that will be converted to HTML, or interface message that will be parsed.
	string\|int\|float	...$params Message parameters, same as wfMessage().

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 677 of file WebInstaller.php.

References MediaWiki\Installer\Installer\parse(), and wfMessage().

◆ showStatusBox()

MediaWiki\Installer\WebInstaller::showStatusBox ( $status )

Output an error or warning box using a Status object.

Parameters

Status $status

Definition at line 1035 of file WebInstaller.php.

◆ showStatusMessage()

MediaWiki\Installer\WebInstaller::showStatusMessage ( Status $status )

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

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 693 of file WebInstaller.php.

References StatusValue\getMessages(), and MediaWiki\Installer\WebInstaller\showWarning().

◆ showSuccess()

MediaWiki\Installer\WebInstaller::showSuccess	(		$msg,
			$params )

Display a success message.

Parameters

string \| MessageSpecifier	$msg	String of wikitext that will be converted to HTML, or interface message that will be parsed.
	string\|int\|float	...$params Message parameters, same as wfMessage().

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 669 of file WebInstaller.php.

References MediaWiki\Installer\Installer\parse(), and wfMessage().

◆ showWarning()

MediaWiki\Installer\WebInstaller::showWarning	(		$msg,
			$params )

Display a warning message.

Parameters

string \| MessageSpecifier	$msg	String of wikitext that will be converted to HTML, or interface message that will be parsed.
	string\|int\|float	...$params Message parameters, same as wfMessage().

Reimplemented from MediaWiki\Installer\Installer.

Definition at line 685 of file WebInstaller.php.

References MediaWiki\Installer\Installer\parse(), and wfMessage().

Referenced by MediaWiki\Installer\WebInstaller\showStatusMessage().

◆ startSession()

MediaWiki\Installer\WebInstaller::startSession ( )

Start the PHP session.

This may be called before execute() to start the PHP session.

Exceptions

Exception

Returns: bool

Definition at line 313 of file WebInstaller.php.

References wfIniGetBool().

Member Data Documentation

◆ $currentPageName

string MediaWiki\Installer\WebInstaller::$currentPageName

protected

Name of the page we're on.

Definition at line 151 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\getDocUrl().

◆ $happyPages

bool [] MediaWiki\Installer\WebInstaller::$happyPages

protected

Array of pages which have declared that they have been submitted, have validated their input, and need no further processing.

Definition at line 114 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\finish().

◆ $helpBoxId

int MediaWiki\Installer\WebInstaller::$helpBoxId = 1

protected

Numeric index of the help box.

Definition at line 144 of file WebInstaller.php.

◆ $otherPages

string [] MediaWiki\Installer\WebInstaller::$otherPages

protected

Initial value:

= [
        'Restart',
        'ReleaseNotes',
        'Copying',
        'UpgradeDoc', 
    ]

Out of sequence pages, selectable by the user at any time.

Definition at line 101 of file WebInstaller.php.

◆ $output

WebInstallerOutput MediaWiki\Installer\WebInstaller::$output

Definition at line 50 of file WebInstaller.php.

◆ $pageSequence

string [] MediaWiki\Installer\WebInstaller::$pageSequence

Initial value:

= [
        'Language',
        'ExistingWiki',
        'Welcome',
        'DBConnect',
        'Upgrade',
        'DBSettings',
        'Name',
        'Options',
        'Install',
        'Complete',
    ]

The main sequence of page names.

These will be displayed in turn.

To add a new installer page:

Add it to this WebInstaller::$pageSequence property
Add a "config-page-<name>" message
Add a "WebInstaller<name>" class

Definition at line 83 of file WebInstaller.php.

◆ $phpErrors

string [] MediaWiki\Installer\WebInstaller::$phpErrors

protected

Captured PHP error text.

Temporary.

Definition at line 71 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\getPhpErrors().

◆ $request

WebRequest MediaWiki\Installer\WebInstaller::$request

WebRequest object.

Definition at line 57 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\__construct().

◆ $session

array [] MediaWiki\Installer\WebInstaller::$session

protected

Cached session array.

Definition at line 64 of file WebInstaller.php.

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

◆ $showSessionWarning

bool MediaWiki\Installer\WebInstaller::$showSessionWarning = false

Flag indicating that session data may have been lost.

Definition at line 130 of file WebInstaller.php.

◆ $skippedPages

bool [] MediaWiki\Installer\WebInstaller::$skippedPages

protected

List of "skipped" pages.

These are pages that will automatically continue to the next page on any GET request. To avoid breaking the "back" button, they need to be skipped during a back operation.

Definition at line 123 of file WebInstaller.php.

Referenced by MediaWiki\Installer\WebInstaller\finish().

◆ $tabIndex

int MediaWiki\Installer\WebInstaller::$tabIndex = 1

protected

Numeric index of the page we're on.

Definition at line 137 of file WebInstaller.php.

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

includes/installer/WebInstaller.php

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ detectWebPaths()

◆ doUpgrade()

◆ envCheckPath()

◆ envGetDefaultServer()

◆ errorHandler()

◆ execute()

◆ finish()

◆ getAcceptLanguage()

◆ getCheckBox()

◆ getDefaultServer()

◆ getDocUrl()

◆ getFingerprint()

◆ getHelpBox()

◆ getInfoBox()

◆ getLocalSettingsLocation()

◆ getLowestUnhappy()

◆ getPageByName()

◆ getPasswordBox()

◆ getPhpErrors()

◆ getRadioElements()

◆ getRadioSet()

◆ getSession()

◆ getTextArea()

◆ getTextBox()

◆ getUrl()

◆ label()

◆ makeLinkItem()

◆ needsUpgrade()

◆ nextTabIndex()

◆ outputCss()

◆ outputHandler()

◆ reset()

◆ setSession()

◆ setupLanguage()

◆ setVarsFromRequest()

◆ showError()

◆ showMessage()

◆ showStatusBox()

◆ showStatusMessage()

◆ showSuccess()

◆ showWarning()

◆ startSession()

Member Data Documentation

◆ $currentPageName

◆ $happyPages

◆ $helpBoxId

◆ $otherPages

◆ $output

◆ $pageSequence

◆ $phpErrors

◆ $request

◆ $session

◆ $showSessionWarning

◆ $skippedPages

◆ $tabIndex