Manual:Update.php

Details
update.php checks if the schema>Special:MyLanguage/Manual:Database layout|MediaWiki database schema needs to be updated in order to work with the current version of MediaWiki. You should run  after each upgrade>Special:MyLanguage/Manual:Upgrading|upgrade of MediaWiki or after the update or install of an extension that requires a schema update. Most extensions that require schema updates will say so in their documentation.

From the browser
If you do not have access to the command line of your server, then use the web updater to run the update script.


 * &rarr; webupd>Manual:Upgrading#Web browser|Web updater 

From the command line
From the command line, or an SSH shell or similar:


 * Change to the  directory


 * Run the update script:

 $ php update.php

 $ mwscript update.php

Parameters
This script offers several parameters (generic, script dependent and script specific) which may be required in some wiki environments.

Generic maintenance parameters

 * used to get a prompt of all available script parameters (generic, script dependent and script specific) together with short explanations of their usage. These are less often used parameters.
 * used to get a prompt of all available script parameters (generic, script dependent and script specific) together with short explanations of their usage. These are less often used parameters.


 * update wiki family if database name depends on virtual host, where wikiId - database name (e.g. enwiki, dewiki ...)
 * update wiki family if database name depends on virtual host, where wikiId - database name (e.g. enwiki, dewiki ...)

Script specific parameters

 * skip countdown sequence
 * skip countdown sequence


 * do not purge objectcache table. Normally   purges the  table (generally contains the parser cache and the messages cache),  and  (these are used for </> message caching and are cleared in 1.21 and later) tables in the database, if you don't want to purge this table, use the <tvar|nopurge> </> option.
 * do not purge <tvar|1>objectcache</> table. Normally <tvar|1> </> purges the <tvar|2></> table (generally contains the parser cache and the messages cache), <tvar|3></> and <tvar|4></> (these are used for <tvar|loader></> message caching and are cleared in 1.21 and later) tables in the database, if you don't want to purge this table, use the <tvar|nopurge> </> option.


 * Update shareddb>Special:MyLanguage/Manual:Shared_database</>|shared tables as well.
 * Update shareddb>Special:MyLanguage/Manual:Shared_database</>|shared tables as well.


 * Run this script even if it is disabled by configuration options.
 * Run this script even if it is disabled by configuration options.


 * Specifies the config file (the LocalSettings.php file for the specific wiki). Used for man>Special:MyLanguage/Manual:Wiki family#Using conf parameter</>|wiki families.
 * Specifies the config file (the LocalSettings.php file for the specific wiki). Used for man>Special:MyLanguage/Manual:Wiki family#Using conf parameter</>|wiki families.


 * All changes to the table structure or table additions are skipped. Only data changes are made.
 * All changes to the table structure or table additions are skipped. Only data changes are made.


 * No schema changes are made to the database, but the schema changes are saved to a separate SQL file that can be run.
 * No schema changes are made to the database, but the schema changes are saved to a separate SQL file that can be run.


 * Skips compatibility checks
 * Skips compatibility checks


 * when using <tvar|1>composer.local.json</> to let Composer install extensions and their dependencies, you may see an error message saying that there is a mismatch between the installed and required version (e.g. "<tvar|2>mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required</>"). You can use this parameter to ignore the message and run <tvar|1>update.php</> regardless.
 * when using <tvar|1>composer.local.json</> to let Composer install extensions and their dependencies, you may see an error message saying that there is a mismatch between the installed and required version (e.g. "<tvar|2>mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required</>"). You can use this parameter to ignore the message and run <tvar|1>update.php</> regardless.

Extensions can install/update their schemas using <tvar|updhook></> hook.