Class for setting up the MediaWiki database using Microsoft SQL Server. More...

Inheritance diagram for MssqlInstaller:

Collaboration diagram for MssqlInstaller:

[legend]

Public Member Functions
	canCreateAccounts ()
	Return true if the install user can create accounts. More...

	createTables ()
	Create database tables from scratch. More...

	getConnectForm ()

	getGlobalDefaults ()
	Get a name=>value map of MW configuration globals for the default values. More...

	getLocalSettings ()
	Get the DBMS-specific options for LocalSettings.php generation. More...

	getName ()

	getSchemaVars ()
	Get variables to substitute into tables.sql and the SQL patch files. More...

	getSettingsForm ()

	isCompiled ()

	openConnection ()

	preInstall ()
	Allow DB installers a chance to make last-minute changes before installation occurs. More...

	preUpgrade ()
	Allow DB installers a chance to make checks before upgrade. More...

	setupDatabase ()

	setupUser ()

	submitConnectForm ()
	Set variables based on the request array, assuming it was submitted via the form returned by getConnectForm(). More...

	submitSettingsForm ()

Public Member Functions inherited from DatabaseInstaller
	__construct ( $parent)
	Construct and initialise parent. More...

	checkPrerequisites ()
	Checks for installation prerequisites other than those checked by isCompiled() More...

	createExtensionTables ()
	Create the tables for each extension the user enabled. More...

	doUpgrade ()
	Perform database upgrades. More...

	enableLB ()
	Set up LBFactory so that wfGetDB() etc. More...

	getCheckBox ( $var, $label, $attribs=[], $helpData="")
	Get a labelled checkbox to configure a local boolean variable. More...

	getConnection ()
	Connect to the database using the administrative user/password currently defined in the session. More...

	getGlobalNames ()
	Get an array of MW configuration globals that will be configured by this class. More...

	getInstallUserBox ()
	Get a standard install-user fieldset. More...

	getInternalDefaults ()
	Get a name=>value map of internal variables used during installation. More...

	getPasswordBox ( $var, $label, $attribs=[], $helpData="")
	Get a labelled password box to configure a local variable. More...

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

	getReadableName ()
	Get the internationalised name for this DBMS. More...

	getSchemaPath ( $db)
	Return a path to the DBMS-specific schema file, otherwise default to tables.sql. More...

	getTextBox ( $var, $label, $attribs=[], $helpData="")
	Get a labelled text box to configure a local variable. More...

	getUpdateKeysPath ( $db)
	Return a path to the DBMS-specific update key file, otherwise default to update-keys.sql. More...

	getVar ( $var, $default=null)
	Get a variable, taking local defaults into account. More...

	getWebUserBox ( $noCreateMsg=false)
	Get a standard web-user fieldset. More...

	insertUpdateKeys ()
	Insert update keys into table to prevent running unneded updates. More...

	needsUpgrade ()
	Determine whether an existing installation of MediaWiki is present in the configured administrative connection. More...

	outputHandler ( $string)

	populateInterwikiTable ()
	Common function for databases that don't understand the MySQLish syntax of interwiki.sql. More...

	setupSchemaVars ()
	Set appropriate schema variables in the current database connection. More...

	setVar ( $name, $value)
	Convenience alias for $this->parent->setVar() More...

	setVarsFromRequest ( $varNames)
	Convenience function to set variables based on form data. More...

	submitInstallUserBox ()
	Submit a standard install user fieldset. More...

	submitWebUserBox ()
	Submit the form from getWebUserBox(). More...

Public Attributes
	$minimumVersion = '9.00.1399'

	$webUserPrivs

Public Attributes inherited from DatabaseInstaller
Database	$db = null
	The database connection. More...

WebInstaller	$parent
	The Installer object. More...

Protected Attributes
	$globalNames

	$internalDefaults

Protected Attributes inherited from DatabaseInstaller
array	$globalNames = []
	Array of MW configuration globals this class uses. More...

array	$internalDefaults = []
	Internal variables for installation. More...

Private Member Functions
	catalogExists ( $catalogName)
	Try to see if a given fulltext catalog exists We assume we already have the appropriate database selected. More...

	databaseExists ( $dbName)
	Try to see if a given database exists. More...

	loginExists ( $user)
	Try to see if the login exists. More...

	schemaExists ( $schemaName)
	Try to see if a given schema exists We assume we already have the appropriate database selected. More...

	userExists ( $user)
	Try to see if the user account exists We assume we already have the appropriate database selected. More...

Additional Inherited Members
Static Protected Member Functions inherited from DatabaseInstaller
static	checkExtension ( $name)
	Convenience function. More...

Detailed Description

Class for setting up the MediaWiki database using Microsoft SQL Server.

Since: 1.23

Definition at line 34 of file MssqlInstaller.php.

Member Function Documentation

◆ canCreateAccounts()

MssqlInstaller::canCreateAccounts ( )

Return true if the install user can create accounts.

Returns: bool

Definition at line 264 of file MssqlInstaller.php.

References $res, $status, as, captcha-old\count, databaseExists(), DatabaseInstaller\getConnection(), DatabaseInstaller\getVar(), and schemaExists().

Referenced by getSettingsForm(), and submitSettingsForm().

◆ catalogExists()

MssqlInstaller::catalogExists ( $catalogName )

private

Try to see if a given fulltext catalog exists We assume we already have the appropriate database selected.

Parameters

string $catalogName Catalog name to check

Returns: bool

Definition at line 712 of file MssqlInstaller.php.

References $res.

Referenced by setupDatabase().

◆ createTables()

MssqlInstaller::createTables ( )

Create database tables from scratch.

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 638 of file MssqlInstaller.php.

References $status, and DatabaseInstaller\getVar().

◆ databaseExists()

MssqlInstaller::databaseExists ( $dbName )

private

Try to see if a given database exists.

Parameters

string $dbName Database name to check

Returns: bool

Definition at line 690 of file MssqlInstaller.php.

References $res.

Referenced by canCreateAccounts(), and setupDatabase().

◆ getConnectForm()

MssqlInstaller::getConnectForm ( )

Returns: string

Reimplemented from DatabaseInstaller.

Definition at line 84 of file MssqlInstaller.php.

References Html\closeElement(), Html\element(), DatabaseInstaller\getPasswordBox(), DatabaseInstaller\getRadioSet(), DatabaseInstaller\getTextBox(), DatabaseInstaller\getVar(), Html\openElement(), text, and wfMessage().

◆ getGlobalDefaults()

MssqlInstaller::getGlobalDefaults ( )

Get a name=>value map of MW configuration globals for the default values.

Returns: array

Reimplemented from DatabaseInstaller.

Definition at line 656 of file MssqlInstaller.php.

◆ getLocalSettings()

MssqlInstaller::getLocalSettings ( )

Get the DBMS-specific options for LocalSettings.php generation.

Returns: string

Reimplemented from DatabaseInstaller.

Definition at line 731 of file MssqlInstaller.php.

References LocalSettingsGenerator\escapePhpString(), and DatabaseInstaller\getVar().

◆ getName()

MssqlInstaller::getName ( )

Returns: string

Reimplemented from DatabaseInstaller.

Definition at line 70 of file MssqlInstaller.php.

◆ getSchemaVars()

MssqlInstaller::getSchemaVars ( )

Get variables to substitute into tables.sql and the SQL patch files.

Returns: array

Reimplemented from DatabaseInstaller.

Definition at line 722 of file MssqlInstaller.php.

References DatabaseInstaller\getVar().

◆ getSettingsForm()

MssqlInstaller::getSettingsForm ( )

Returns: string

Reimplemented from DatabaseInstaller.

Definition at line 361 of file MssqlInstaller.php.

References $s, canCreateAccounts(), Html\closeElement(), Html\element(), DatabaseInstaller\getCheckBox(), DatabaseInstaller\getPasswordBox(), DatabaseInstaller\getRadioSet(), DatabaseInstaller\getTextBox(), DatabaseInstaller\getVar(), Html\openElement(), plain, text, and wfMessage().

◆ isCompiled()

MssqlInstaller::isCompiled ( )

Returns: bool

Reimplemented from DatabaseInstaller.

Definition at line 77 of file MssqlInstaller.php.

References DatabaseInstaller\checkExtension().

◆ loginExists()

MssqlInstaller::loginExists ( $user )

private

Try to see if the login exists.

Parameters

string $user Username to check

Returns: bool

Definition at line 669 of file MssqlInstaller.php.

References $res, and $user.

Referenced by setupUser().

◆ openConnection()

MssqlInstaller::openConnection ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 205 of file MssqlInstaller.php.

References DatabaseInstaller\$db, $e, $status, $user, $wgDBWindowsAuthentication, DatabaseInstaller\getVar(), global, and StatusValue\newGood().

◆ preInstall()

MssqlInstaller::preInstall ( )

Allow DB installers a chance to make last-minute changes before installation occurs.

This happens before setupDatabase() or createTables() is called, but long after the constructor. Helpful for things like modifying setup steps :)

Reimplemented from DatabaseInstaller.

Definition at line 482 of file MssqlInstaller.php.

◆ preUpgrade()

MssqlInstaller::preUpgrade ( )

Allow DB installers a chance to make checks before upgrade.

Reimplemented from DatabaseInstaller.

Definition at line 238 of file MssqlInstaller.php.

References $status, $wgDBpassword, $wgDBuser, DatabaseInstaller\getConnection(), DatabaseInstaller\getVar(), and global.

◆ schemaExists()

MssqlInstaller::schemaExists ( $schemaName )

private

Try to see if a given schema exists We assume we already have the appropriate database selected.

Parameters

string $schemaName Schema name to check

Returns: bool

Definition at line 701 of file MssqlInstaller.php.

References $res.

Referenced by canCreateAccounts(), and setupDatabase().

◆ setupDatabase()

MssqlInstaller::setupDatabase ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 494 of file MssqlInstaller.php.

References $status, catalogExists(), databaseExists(), DatabaseInstaller\getConnection(), DatabaseInstaller\getVar(), schemaExists(), and DatabaseInstaller\setupSchemaVars().

◆ setupUser()

MssqlInstaller::setupUser ( )

Returns: Status

Definition at line 530 of file MssqlInstaller.php.

References $name, $status, as, DatabaseInstaller\getConnection(), DatabaseInstaller\getVar(), loginExists(), StatusValue\newGood(), DatabaseInstaller\setupSchemaVars(), and userExists().

◆ submitConnectForm()

MssqlInstaller::submitConnectForm ( )

Set variables based on the request array, assuming it was submitted via the form returned by getConnectForm().

Validate the connection settings by attempting to connect with them.

If this is called, $this->parent can be assumed to be a WebInstaller.

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 142 of file MssqlInstaller.php.

References $status, DatabaseInstaller\getConnection(), StatusValue\newFatal(), StatusValue\newGood(), DatabaseInstaller\setVar(), and DatabaseInstaller\setVarsFromRequest().

◆ submitSettingsForm()

MssqlInstaller::submitSettingsForm ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 415 of file MssqlInstaller.php.

References $e, $user, canCreateAccounts(), DatabaseInstaller\getVar(), StatusValue\newFatal(), StatusValue\newGood(), DatabaseInstaller\setVar(), and DatabaseInstaller\setVarsFromRequest().

◆ userExists()

MssqlInstaller::userExists ( $user )

private

Try to see if the user account exists We assume we already have the appropriate database selected.

Parameters

string $user Username to check

Returns: bool

Definition at line 680 of file MssqlInstaller.php.

References $res, and $user.

Referenced by setupUser().

Member Data Documentation

◆ $globalNames

MssqlInstaller::$globalNames

protected

Initial value:

= [
        'wgDBserver',
        'wgDBname',
        'wgDBuser',
        'wgDBpassword',
        'wgDBmwschema',
        'wgDBprefix',
        'wgDBWindowsAuthentication',
    ]

Definition at line 36 of file MssqlInstaller.php.

◆ $internalDefaults

MssqlInstaller::$internalDefaults

protected

Initial value:

= [
        '_InstallUser' => 'sa',
        '_InstallWindowsAuthentication' => 'sqlauth',
        '_WebWindowsAuthentication' => 'sqlauth',
    ]

Definition at line 46 of file MssqlInstaller.php.

◆ $minimumVersion

MssqlInstaller::$minimumVersion = '9.00.1399'

Definition at line 54 of file MssqlInstaller.php.

◆ $webUserPrivs

MssqlInstaller::$webUserPrivs

Initial value:

= [
        'DELETE',
        'INSERT',
        'SELECT',
        'UPDATE',
        'EXECUTE',
    ]

Definition at line 59 of file MssqlInstaller.php.

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

includes/installer/MssqlInstaller.php

Public Member Functions

Public Attributes

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ canCreateAccounts()

◆ catalogExists()

◆ createTables()

◆ databaseExists()

◆ getConnectForm()

◆ getGlobalDefaults()

◆ getLocalSettings()

◆ getName()

◆ getSchemaVars()

◆ getSettingsForm()

◆ isCompiled()

◆ loginExists()

◆ openConnection()

◆ preInstall()

◆ preUpgrade()

◆ schemaExists()

◆ setupDatabase()

◆ setupUser()

◆ submitConnectForm()

◆ submitSettingsForm()

◆ userExists()

Member Data Documentation

◆ $globalNames

◆ $internalDefaults

◆ $minimumVersion

◆ $webUserPrivs