Manual:Update.php/de

MediaWiki-Datei: update.php
Speicherort:	maintenance/
Quellcode:	master • 1.43.0 • 1.42.4 • 1.39.11
Klassen:	UpdateMediaWiki

Einzelheiten

update.php prüft, ob das MediaWiki-Datenbankschema aktualisiert werden muss, um mit der aktuellen Version von MediaWiki zu arbeiten. Das update.php-Skript sollte nach jeder Aktualisierung der MediaWiki-Software oder dem Installieren einer Erweiterung, die ein Schema-Update erfordert, ausgeführt werden. Die meisten Erweiterungen, die ein Schema-Update erfordern, werden dies in ihrer Dokumentation angeben.

This maintenance script can be disabled via $wgAllowSchemaUpdates . People with extremely large and busy wikis may need to do upgrades with care, but if you're not sure if that applies to you, then it probably doesn't.

Usage

Warnung:

update.php kann mit Fehlern abbrechen und die Datenbank in einem inkonsistenten Zustand zurücklassen. Legen Sie daher unbedingt immer ein Backup der Datenbank an, bevor Sie das Skript laufen lassen! Always backup the database before running the script!

Zugriff über den Browser

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

→ Web updater

From the command line

Von der Befehlszeile oder einer SSH-Shell oder ähnlichem:

$ php maintenance/run.php update

Use the following on Vagrant instances (from within your vagrant ssh).

$ mwscript update.php

Parameter

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

Generic maintenance parameters

--help

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.

--wiki wikiId

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

--conf

Specifies the config file (the LocalSettings.php file for the specific wiki). Verwendung für Wiki-Familien.

Script specific parameters

--quick

skip countdown sequence

--initial

(eingeführt in 1.43) Do initial updates required after manual installation using tables-generated.sql

--doshared

Update shared tables as well.

--noschema

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

--schema

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

Allows "update.php" to be run when $wgAllowSchemaUpdates is set to false. This is useful for non-WMF environments where strict DB permissions allow database updates (which "update.php" performs), but no schema changes (such as adding or dropping tables or indexes, which "update.php" also performs).

--force

Run this script even if configuration options disable it.

--skip-external-dependencies

when using 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. "mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required"). You can use this parameter to ignore the message and run update.php regardless.

Warnung:

Only recommended for use by developers.

--skip-config-validation

(eingeführt in 1.39) Skips checking whether the existing configuration is valid. Otherwise, this script will not run if an invalid configuration is detected.

--skip-compat-checks

(entfernt in 1.41) Skips compatibility checks (Gerrit change 851684)

--nopurge

(entfernt in 1.36) do not purge objectcache table. Normally update.php purges the objectcache table (generally contains the parser cache and the messages cache), msg_resource and msg_resource_links (these are used for ResourceLoader 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 --nopurge option.

Extensions can install/update their schemas using the LoadExtensionSchemaUpdates hook.

Siehe auch

• Handbuch:$wgDBadminuser and Handbuch:$wgDBadminpassword

• For detailed instruction on using update.php, see Handbuch:Aktualisierung , Manual:Upgrading#Command_line