Inheritance diagram for MysqlUpdater:

Collaboration diagram for MysqlUpdater:

[legend]

Public Member Functions
	getSchemaVars ()
	Get appropriate schema variables in the current database connection.

Public Member Functions inherited from DatabaseUpdater
	addExtensionField ( $tableName, $columnName, $sqlPath)
	Add a field to an existing extension table.

	addExtensionIndex ( $tableName, $indexName, $sqlPath)
	Add an index to an existing extension table.

	addExtensionTable ( $tableName, $sqlPath)
	Convenience wrapper for addExtensionUpdate() when adding a new table (which is the most common usage of updaters in an extension) Intended for use in LoadExtensionSchemaUpdates hook handlers.

	addExtensionUpdate (array $update)
	Add a new update coming from an extension.

	addPostDatabaseUpdateMaintenance ( $class)
	Add a maintenance script to be run after the database updates are complete.

	doUpdates (array $what=[ 'core', 'extensions', 'stats'])
	Do all the updates.

	dropExtensionField ( $tableName, $columnName, $sqlPath)
	Drop a field from an extension table.

	dropExtensionIndex ( $tableName, $indexName, $sqlPath)
	Drop an index from an extension table Intended for use in LoadExtensionSchemaUpdates hook handlers.

	dropExtensionTable ( $tableName, $sqlPath=false)
	Drop an extension table.

	getDB ()
	Get a database connection to run updates.

	getPostDatabaseUpdateMaintenance ()

	insertUpdateRow ( $key, $val=null)
	Helper function: Add a key to the updatelog table.

	modifyExtensionField ( $tableName, $fieldName, $sqlPath)
	Modify an existing field in an extension table.

	modifyExtensionTable ( $tableName, $sqlPath)
	Modify an existing extension table.

	output ( $str)
	Output some text.

	patchPath (IDatabase $db, $patch)
	Get the full path of a patch file.

	purgeCache ()
	Purge various database caches.

	renameExtensionIndex ( $tableName, $oldIndexName, $newIndexName, $sqlPath, $skipBothIndexExistWarning=false)
	Rename an index on an extension table Intended for use in LoadExtensionSchemaUpdates hook handlers.

	setAutoExtensionHookContainer (HookContainer $hookContainer)
	Set the HookContainer to use for loading extension schema updates.

	setFileAccess ()
	Set any .htaccess files or equivilent for storage repos.

	tableExists ( $tableName)

	updateRowExists ( $key)
	Helper function: check if the given key is present in the updatelog table.

Protected Member Functions
	checkBin ( $table, $field, $patchFile)
	MW 1.4 betas were missing the 'binary' marker from logging.log_title, which caused a MySQL collation mismatch error.

	doBacklinkingIndicesUpdate ()

	doCategorylinksIndicesUpdate ()

	doCategoryPopulation ()

	doClFieldsUpdate ()

	doExtendCommentLengths ()

	doFilearchiveIndicesUpdate ()

	doFixAncientImagelinks ()

	doFixIpbAddressUniqueIndex ()

	doIndexUpdate ()
	Check that proper indexes are in place.

	doInterwikiUpdate ()
	Check that interwiki table exists; if it doesn't source it.

	doIwlinksIndexNonUnique ()

	doLanguageLinksLengthSync ()

	doNamespaceSize ()

	doNonUniquePlTlIl ()

	doOldLinksUpdate ()

	doPagelinksUpdate ()

	doPageRandomUpdate ()
	Set page_random field to a random value where it is equals to 0.

	doPopulateParentId ()

	doRestrictionsUpdate ()
	Adding page_restrictions table, obsoleting page.page_restrictions.

	doRevisionPageRevIndexNonUnique ()

	doSchemaRestructuring ()

	doTemplatelinksUpdate ()

	doUnsignedSyncronisation ()

	doUpdateMimeMinorField ()

	doUserGroupsUpdate ()

	doUserNewTalkTimestampNotNull ()

	doUserUniqueUpdate ()

	doWatchlistNull ()
	Make sure wl_notificationtimestamp can be NULL, and update old broken items.

	doWatchlistUpdate ()
	Check if we need to add talk page rows to the watchlist.

	getCoreUpdateList ()
	Get an array of updates to perform on the database.

	indexHasField ( $table, $index, $field)
	Check whether an index contain a field.

Protected Member Functions inherited from DatabaseUpdater
	__construct (IMaintainableDatabase &$db, $shared, Maintenance $maintenance=null)
	Stable to call.

	addField ( $table, $field, $patch, $fullpath=false)
	Add a new field to an existing table.

	addIndex ( $table, $index, $patch, $fullpath=false)
	Add a new index to an existing table.

	addIndexIfNoneExist ( $table, $indexes, $patch, $fullpath=false)
	Add a new index to an existing table if none of the given indexes exist.

	addTable ( $name, $patch, $fullpath=false)
	Add a new table to the database.

	appendLine ( $line)
	Append a line to the open filehandle.

	applyPatch ( $path, $isFullPath=false, $msg=null)
	Applies a SQL patch.

	canUseNewUpdatelog ()
	Updatelog was changed in 1.17 to have a ul_value column so we can record more information about what kind of updates we've done (that's what this class does).

	checkStats ()
	Check the site_stats table is not properly populated.

	copyFile ( $filename)
	Append an SQL fragment to the open file handle.

	doActiveUsersInit ()
	Sets the number of active users in the site_stats table.

	doCollationUpdate ()
	Update CategoryLinks collation.

	doLogSearchPopulation ()
	Migrate log params to new table and index for searching.

	doLogUsertextPopulation ()
	Populates the log_user_text field in the logging table.

	doMigrateUserOptions ()
	Migrates user options from the user table blob to user_properties.

	doTable ( $name)
	Returns whether updates should be executed on the database table $name.

	dropField ( $table, $field, $patch, $fullpath=false)
	Drop a field from an existing table.

	dropIndex ( $table, $index, $patch, $fullpath=false)
	Drop an index from an existing table.

	dropTable ( $table, $patch=false, $fullpath=false)
	If the specified table exists, drop it, or execute the patch if one is provided.

	getExtensionUpdates ()
	Get the list of extension-defined updates.

	getOldGlobalUpdates ()
	Before 1.17, we used to handle updates via stuff like $wgExtNewTables/Fields/Indexes.

	ifFieldExists ( $table, $field, $func,... $params)
	Only run a function if the named field exists.

	ifNoActorTable ( $func,... $params)

	ifTableNotExists ( $table, $func,... $params)
	Only run a function if a table does not exist.

	migrateActors ()
	Migrate actors to the new 'actor' table.

	migrateArchiveText ()
	Migrate ar_text to modern storage.

	migrateComments ()
	Migrate comments to the new 'comment' table.

	migrateImageCommentTemp ()
	Merge `image_comment_temp` into the `image` table.

	modifyField ( $table, $field, $patch, $fullpath=false)
	Modify an existing field.

	modifyTable ( $table, $patch, $fullpath=false)
	Modify an existing table, similar to modifyField.

	populateArchiveRevId ()
	Populate ar_rev_id, then make it not nullable.

	populateContentTables ()
	Populates the MCR content tables.

	populateExternallinksIndex60 ()
	Populates the externallinks.el_index_60 field.

	rebuildLocalisationCache ()
	Rebuilds the localisation cache.

	renameIndex ( $table, $oldIndex, $newIndex, $skipBothIndexExistWarning, $patch, $fullpath=false)
	Rename an index from an existing table Stable to override.

	runMaintenance ( $class, $script)
	Run a maintenance script.

Additional Inherited Members
Static Public Member Functions inherited from DatabaseUpdater
static	newForDB (IMaintainableDatabase $db, $shared=false, Maintenance $maintenance=null)

Public Attributes inherited from DatabaseUpdater
const	REPLICATION_WAIT_TIMEOUT = 300

Protected Attributes inherited from DatabaseUpdater
HookContainer null	$autoExtensionHookContainer

IMaintainableDatabase	$db
	Handle to the database subclass.

array	$extensionUpdates = []
	List of extension-provided database updates.

resource	$fileHandle = null
	File handle for SQL output.

Maintenance	$maintenance

string[]	$postDatabaseUpdateMaintenance
	Scripts to run after database update Should be a subclass of LoggedUpdateMaintenance.

	$shared = false

bool	$skipSchema = false
	Flag specifying whether or not to skip schema (e.g.

array	$updates = []
	Array of updates to perform on the database.

array	$updatesSkipped = []
	Array of updates that were skipped.

Detailed Description

Definition at line 34 of file MysqlUpdater.php.

Member Function Documentation

◆ checkBin()

MysqlUpdater::checkBin	(	$table,
		$field,
		$patchFile
	)

protected

MW 1.4 betas were missing the 'binary' marker from logging.log_title, which caused a MySQL collation mismatch error.

Parameters

string	$table	Table name
string	$field	Field name to check
string	$patchFile	Path to the patch to correct the field

Returns: bool

Definition at line 458 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), and DatabaseUpdater\output().

◆ doBacklinkingIndicesUpdate()

MysqlUpdater::doBacklinkingIndicesUpdate ( )

protected

Definition at line 1054 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and indexHasField().

◆ doCategorylinksIndicesUpdate()

MysqlUpdater::doCategorylinksIndicesUpdate ( )

protected

Definition at line 1092 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and indexHasField().

◆ doCategoryPopulation()

MysqlUpdater::doCategoryPopulation ( )

protected

Definition at line 1098 of file MysqlUpdater.php.

References DatabaseUpdater\output(), and DatabaseUpdater\updateRowExists().

◆ doClFieldsUpdate()

MysqlUpdater::doClFieldsUpdate ( )

protected

Definition at line 1172 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\output(), and DatabaseUpdater\updateRowExists().

◆ doExtendCommentLengths()

MysqlUpdater::doExtendCommentLengths ( )

protected

Definition at line 1326 of file MysqlUpdater.php.

References $res, DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doFilearchiveIndicesUpdate()

MysqlUpdater::doFilearchiveIndicesUpdate ( )

protected

Definition at line 1128 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch().

◆ doFixAncientImagelinks()

MysqlUpdater::doFixAncientImagelinks ( )

protected

Definition at line 541 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doFixIpbAddressUniqueIndex()

MysqlUpdater::doFixIpbAddressUniqueIndex ( )

protected

Definition at line 1211 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), indexHasField(), and DatabaseUpdater\output().

◆ doIndexUpdate()

MysqlUpdater::doIndexUpdate ( )

protected

Check that proper indexes are in place.

Definition at line 522 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doInterwikiUpdate()

MysqlUpdater::doInterwikiUpdate ( )

protected

Check that interwiki table exists; if it doesn't source it.

Definition at line 498 of file MysqlUpdater.php.

References $IP, DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), and DatabaseUpdater\output().

◆ doIwlinksIndexNonUnique()

MysqlUpdater::doIwlinksIndexNonUnique ( )

protected

Definition at line 1250 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doLanguageLinksLengthSync()

MysqlUpdater::doLanguageLinksLengthSync ( )

protected

Definition at line 1186 of file MysqlUpdater.php.

References $res, $s, DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doNamespaceSize()

MysqlUpdater::doNamespaceSize ( )

protected

Definition at line 816 of file MysqlUpdater.php.

References DatabaseUpdater\output().

◆ doNonUniquePlTlIl()

MysqlUpdater::doNonUniquePlTlIl ( )

protected

Definition at line 1137 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doOldLinksUpdate()

MysqlUpdater::doOldLinksUpdate ( )

protected

Definition at line 536 of file MysqlUpdater.php.

◆ doPagelinksUpdate()

MysqlUpdater::doPagelinksUpdate ( )

protected

Definition at line 842 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doPageRandomUpdate()

MysqlUpdater::doPageRandomUpdate ( )

protected

Set page_random field to a random value where it is equals to 0.

See also: T5946

Definition at line 992 of file MysqlUpdater.php.

References DatabaseUpdater\output().

◆ doPopulateParentId()

MysqlUpdater::doPopulateParentId ( )

protected

Definition at line 1116 of file MysqlUpdater.php.

References DatabaseUpdater\output(), and DatabaseUpdater\updateRowExists().

◆ doRestrictionsUpdate()

MysqlUpdater::doRestrictionsUpdate ( )

protected

Adding page_restrictions table, obsoleting page.page_restrictions.

Migrating old restrictions to new table – Andrew Garrett, January 2007.

Definition at line 1068 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doRevisionPageRevIndexNonUnique()

MysqlUpdater::doRevisionPageRevIndexNonUnique ( )

protected

Definition at line 1306 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), and DatabaseUpdater\output().

◆ doSchemaRestructuring()

MysqlUpdater::doSchemaRestructuring ( )

protected

Definition at line 634 of file MysqlUpdater.php.

References $wgLegacySchemaConversion, DatabaseUpdater\output(), and wfTimestamp().

◆ doTemplatelinksUpdate()

MysqlUpdater::doTemplatelinksUpdate ( )

protected

Definition at line 1004 of file MysqlUpdater.php.

References $res, DatabaseUpdater\applyPatch(), NS_TEMPLATE, DatabaseUpdater\output(), and DatabaseUpdater\REPLICATION_WAIT_TIMEOUT.

◆ doUnsignedSyncronisation()

MysqlUpdater::doUnsignedSyncronisation ( )

protected

Definition at line 1270 of file MysqlUpdater.php.

References $s, DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), and DatabaseUpdater\output().

◆ doUpdateMimeMinorField()

MysqlUpdater::doUpdateMimeMinorField ( )

protected

Definition at line 1158 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\output(), and DatabaseUpdater\updateRowExists().

◆ doUserGroupsUpdate()

MysqlUpdater::doUserGroupsUpdate ( )

protected

Definition at line 896 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), and DatabaseUpdater\output().

◆ doUserNewTalkTimestampNotNull()

MysqlUpdater::doUserNewTalkTimestampNotNull ( )

protected

Definition at line 1228 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), and DatabaseUpdater\output().

◆ doUserUniqueUpdate()

MysqlUpdater::doUserUniqueUpdate ( )

protected

Definition at line 878 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), DatabaseUpdater\doTable(), and DatabaseUpdater\output().

◆ doWatchlistNull()

MysqlUpdater::doWatchlistNull ( )

protected

Make sure wl_notificationtimestamp can be NULL, and update old broken items.

Definition at line 969 of file MysqlUpdater.php.

References DatabaseUpdater\applyPatch(), and DatabaseUpdater\output().

◆ doWatchlistUpdate()

MysqlUpdater::doWatchlistUpdate ( )

protected

Check if we need to add talk page rows to the watchlist.

Definition at line 563 of file MysqlUpdater.php.

References $res, $wgUpdateRowsPerQuery, and DatabaseUpdater\output().

◆ getCoreUpdateList()

MysqlUpdater::getCoreUpdateList ( )

protected

Get an array of updates to perform on the database.

Should return a multi-dimensional array. The main key is the MediaWiki version (1.12, 1.13...) with the values being arrays of updates, identical to how updaters.inc did it (for now)

Returns: array[]

Reimplemented from DatabaseUpdater.

Definition at line 35 of file MysqlUpdater.php.

◆ getSchemaVars()

MysqlUpdater::getSchemaVars ( )

Get appropriate schema variables in the current database connection.

This should be called after any request data has been imported, but before any write operations to the database. The result should be passed to the DB setSchemaVars() method. Stable to override

Returns: array

Since: 1.28

Reimplemented from DatabaseUpdater.

Definition at line 1342 of file MysqlUpdater.php.

References $wgDBTableOptions.

◆ indexHasField()

MysqlUpdater::indexHasField	(	$table,
		$index,
		$field
	)

protected

Check whether an index contain a field.

Parameters

string	$table	Table name
string	$index	Index name to check
string	$field	Field that should be in the index

Returns: bool

Definition at line 480 of file MysqlUpdater.php.

References DatabaseUpdater\output().

Referenced by doBacklinkingIndicesUpdate(), doCategorylinksIndicesUpdate(), and doFixIpbAddressUniqueIndex().

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

includes/installer/MysqlUpdater.php

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ checkBin()

◆ doBacklinkingIndicesUpdate()

◆ doCategorylinksIndicesUpdate()

◆ doCategoryPopulation()

◆ doClFieldsUpdate()

◆ doExtendCommentLengths()

◆ doFilearchiveIndicesUpdate()

◆ doFixAncientImagelinks()

◆ doFixIpbAddressUniqueIndex()

◆ doIndexUpdate()

◆ doInterwikiUpdate()

◆ doIwlinksIndexNonUnique()

◆ doLanguageLinksLengthSync()

◆ doNamespaceSize()

◆ doNonUniquePlTlIl()

◆ doOldLinksUpdate()

◆ doPagelinksUpdate()

◆ doPageRandomUpdate()

◆ doPopulateParentId()

◆ doRestrictionsUpdate()

◆ doRevisionPageRevIndexNonUnique()

◆ doSchemaRestructuring()

◆ doTemplatelinksUpdate()

◆ doUnsignedSyncronisation()

◆ doUpdateMimeMinorField()

◆ doUserGroupsUpdate()

◆ doUserNewTalkTimestampNotNull()

◆ doUserUniqueUpdate()

◆ doWatchlistNull()

◆ doWatchlistUpdate()

◆ getCoreUpdateList()

◆ getSchemaVars()

◆ indexHasField()