Class for setting up the MediaWiki database using SQLLite. More...

Inheritance diagram for SqliteInstaller:

Collaboration diagram for SqliteInstaller:

[legend]

Public Member Functions
	checkPrerequisites ()

	createTables ()

	getConnectForm ()
	Get HTML for a web form that configures this database.

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

	getLocalSettings ()

	getName ()
	Return the internal name, e.g.

	isCompiled ()

	needsUpgrade ()

	openConnection ()

	setupDatabase ()

	setupSearchIndex (&$status)

	submitConnectForm ()

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

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

	doUpgrade ()
	Perform database upgrades.

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

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

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

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

	getInstallUserBox ()
	Get a standard install-user fieldset.

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

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

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

	getReadableName ()
	Get the internationalised name for this DBMS.

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

	getSchemaVars ()
	Override this to provide DBMS-specific schema variables, to be substituted into tables.sql and other schema files.

	getSettingsForm ()
	Get HTML for a web form that retrieves settings used for installation.

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

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

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

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

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

	outputHandler ( $string)

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

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

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

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

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

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

	submitInstallUserBox ()
	Submit a standard install user fieldset.

	submitSettingsForm ()
	Set variables based on the request array, assuming it was submitted via the form return by getSettingsForm().

	submitWebUserBox ()
	Submit the form from getWebUserBox().

Public Attributes
DatabaseSqlite	$db

const	MINIMUM_VERSION = '3.3.7'

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

WebInstaller	$parent
	The Installer object.

Protected Member Functions
	makeStubDBFile ( $dir, $db)

Protected Attributes
	$globalNames

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

array	$internalDefaults = []
	Internal variables for installation.

Static Private Member Functions
static	dataDirOKmaybeCreate ( $dir, $create=false)

static	realpath ( $path)
	Safe wrapper for PHP's realpath() that fails gracefully if it's unable to canonicalize the path.

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

Detailed Description

Class for setting up the MediaWiki database using SQLLite.

Since: 1.17

Definition at line 30 of file SqliteInstaller.php.

Member Function Documentation

◆ checkPrerequisites()

SqliteInstaller::checkPrerequisites ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 55 of file SqliteInstaller.php.

References $db, DatabaseSqlite\getFulltextSearchModule(), DatabaseSqlite\getServerVersion(), and DatabaseSqlite\newStandaloneInstance().

◆ createTables()

SqliteInstaller::createTables ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 287 of file SqliteInstaller.php.

References $status, and setupSearchIndex().

◆ dataDirOKmaybeCreate()

static SqliteInstaller::dataDirOKmaybeCreate	(	$dir,
		$create = `false`
	)

staticprivate

Parameters

string	$dir
bool	$create

Returns: Status

Definition at line 139 of file SqliteInstaller.php.

References $dir, Installer\maybeGetWebserverPrimaryGroup(), and wfMkdirParents().

Referenced by setupDatabase(), and submitConnectForm().

◆ getConnectForm()

SqliteInstaller::getConnectForm ( )

Get HTML for a web form that configures this database.

Configuration at this time should be the minimum needed to connect and test whether install or upgrade is required.

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

Reimplemented from DatabaseInstaller.

Definition at line 84 of file SqliteInstaller.php.

References DatabaseInstaller\getTextBox().

◆ getGlobalDefaults()

SqliteInstaller::getGlobalDefaults ( )

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

Returns: array

Reimplemented from DatabaseInstaller.

Definition at line 70 of file SqliteInstaller.php.

References $path.

◆ getLocalSettings()

SqliteInstaller::getLocalSettings ( )

Returns: string

Reimplemented from DatabaseInstaller.

Definition at line 315 of file SqliteInstaller.php.

References $dir, and DatabaseInstaller\getVar().

◆ getName()

SqliteInstaller::getName ( )

Return the internal name, e.g.

'mysql', or 'sqlite'.

Reimplemented from DatabaseInstaller.

Definition at line 43 of file SqliteInstaller.php.

◆ isCompiled()

SqliteInstaller::isCompiled ( )

Returns: bool Returns true if the client library is compiled in.

Reimplemented from DatabaseInstaller.

Definition at line 47 of file SqliteInstaller.php.

References DatabaseInstaller\checkExtension().

◆ makeStubDBFile()

SqliteInstaller::makeStubDBFile	(	$dir,
		$db
	)

protected

Parameters

$dir
$db

Returns: Status

Definition at line 269 of file SqliteInstaller.php.

References $db, $dir, and DatabaseSqlite\generateFileName().

Referenced by setupDatabase().

◆ needsUpgrade()

SqliteInstaller::needsUpgrade ( )

Returns: bool

Reimplemented from DatabaseInstaller.

Definition at line 199 of file SqliteInstaller.php.

References $dir, DatabaseSqlite\generateFileName(), and DatabaseInstaller\getVar().

◆ openConnection()

SqliteInstaller::openConnection ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 181 of file SqliteInstaller.php.

References $db, $dir, $e, $status, and DatabaseInstaller\getVar().

◆ realpath()

static SqliteInstaller::realpath ( $path )

staticprivate

Safe wrapper for PHP's realpath() that fails gracefully if it's unable to canonicalize the path.

Parameters

string $path

Returns: string

Definition at line 105 of file SqliteInstaller.php.

References $path, and realpath().

Referenced by realpath(), and submitConnectForm().

◆ setupDatabase()

SqliteInstaller::setupDatabase ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 214 of file SqliteInstaller.php.

References $db, $dir, $e, $status, dataDirOKmaybeCreate(), DatabaseInstaller\getConnection(), DatabaseInstaller\getVar(), makeStubDBFile(), DatabaseInstaller\setupSchemaVars(), and DatabaseInstaller\setVar().

◆ setupSearchIndex()

SqliteInstaller::setupSearchIndex ( & $status )

Parameters

Status $status

Returns: Status

Definition at line 297 of file SqliteInstaller.php.

References $IP, $status, DatabaseSqlite\getFulltextSearchModule(), and global.

Referenced by createTables().

◆ submitConnectForm()

SqliteInstaller::submitConnectForm ( )

Returns: Status

Reimplemented from DatabaseInstaller.

Definition at line 117 of file SqliteInstaller.php.

References $dir, dataDirOKmaybeCreate(), DatabaseInstaller\getVar(), realpath(), DatabaseInstaller\setVar(), and DatabaseInstaller\setVarsFromRequest().

Member Data Documentation

◆ $db

DatabaseSqlite SqliteInstaller::$db

Definition at line 36 of file SqliteInstaller.php.

Referenced by checkPrerequisites(), makeStubDBFile(), openConnection(), and setupDatabase().

◆ $globalNames

SqliteInstaller::$globalNames

protected

Initial value:

= [
        'wgDBname',
        'wgSQLiteDataDir',
    ]

Definition at line 38 of file SqliteInstaller.php.

◆ MINIMUM_VERSION

const SqliteInstaller::MINIMUM_VERSION = '3.3.7'

Definition at line 31 of file SqliteInstaller.php.

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

includes/installer/SqliteInstaller.php

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Static Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ checkPrerequisites()

◆ createTables()

◆ dataDirOKmaybeCreate()

◆ getConnectForm()

◆ getGlobalDefaults()

◆ getLocalSettings()

◆ getName()

◆ isCompiled()

◆ makeStubDBFile()

◆ needsUpgrade()

◆ openConnection()

◆ realpath()

◆ setupDatabase()

◆ setupSearchIndex()

◆ submitConnectForm()

Member Data Documentation

◆ $db

◆ $globalNames

◆ MINIMUM_VERSION