Manual:$wgSharedTables

Translate this page

Shared DB settings: $wgSharedTables
List of database tables (without prefixes) to share when `$wgSharedDB` is enabled.
Introduced in version:	1.13.0 (r34353)
Removed in version:	Still in use
Allowed values:	(array of strings)
Default value:	see below
Other settings: Alphabetical \| By function

Details

This only includes the user table by default for backwards compatibility. However you may remove it so that you can enable extensions using the shared DB without having shared users. Or you can add in another table, such as interwiki to force MediaWiki to use the shared version of the table instead.

Be careful with sharing tables. The images, revisions, pages, and many of the other tables may have bad side effects if you share them.

In 1.16 (r56741), the new table for storing user preferences was added - user_properties .

See Manual:Shared database for usage information.

Default value

MediaWiki version:

≥ 1.39

$wgSharedTables = [
	'user',
	'user_properties',
	'user_autocreate_serial',
];

MediaWiki versions:

1.27 – 1.38

$wgSharedTables = [
	'user',
	'user_properties',
];

MediaWiki versions:

1.13 – 1.26

$wgSharedTables = array( 'user', 'user_properties' );

Upgrading

As of MediaWiki 1.21, $wgSharedTables must be temporarily cleared during upgrade. Otherwise, the shared tables are not touched at all (neither tables with $wgSharedPrefix , nor those with $wgDBprefix ), which may lead to failed upgrade.

Example

If you wanted to share the ipblocks table, you would use:

$wgSharedTables[] = 'ipblocks';

Details

Default value

Upgrading

Example

See also