Handbuch:update.php
MediaWiki-Datei: update.php | |
---|---|
Speicherort: | maintenance/ |
Quellcode: | master • 1.44.0 • 1.43.3 • 1.39.13 |
Klassen: | UpdateMediaWiki |
Einzelheiten
Das Wartungsskript 'update.php' prüft, ob das MediaWiki-Datenbankschema aktualisiert werden muss, um mit der aktuellen Version von MediaWiki zu arbeiten.
Das
-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, geben dies in ihrer Dokumentation an.
update.php
$wgAllowSchemaUpdates
deaktiviert werden. Leute mit sehr großen und stark frequentierten Wikis müssen Upgrades mit Sorgfalt durchführen. Wenn Sie sich nicht sicher sind, ob das für Sie gilt, dann ist es wahrscheinlich nicht der Fall.
Verwendung
Zugriff über den Browser
Wenn Sie keinen Zugriff auf die Kommandozeile Ihres Servers haben, können sie den Web-Updater nutzen, um das Update-Skript auszuführen.
Zugriff über die Kommandozeile
Nutzen Sie Folgendes aus der Befehlszeile, einer SSH-Shell oder ähnlichem:
MediaWiki Version: | ≥ 1.40 |
$ php maintenance/run.php update
MediaWiki Version: | ≤ 1.39 |
$ php maintenance/update.php
Verwenden Sie das Folgende bei Vagrant -Instanzen (von Ihrem Vagrant-SSH aus).
$ mwscript update.php
Parameter
Dieses Skript bietet mehrere Parameter (allgemein, skriptabhängig und skriptspezifisch), die in einigen Wiki-Umgebungen erforderlich sein können.
Allgemeine Wartungsparameter:
--help
- Wird benutzt, um alle verfügbaren Skriptparameter (allgemein, skriptabhängig und skriptspezifisch) zusammen mit kurzen Erläuterungen ihrer Verwendung zu erhalten. Dies sind weniger häufig verwendete Parameter.
--wiki wikiId
- Aktualisiert die Wiki-Familie, wenn der Datenbankname von einem virtuellen Host abhängt, wobei wikiId dem Namen der Datenbank (z. B. enwiki, dewiki, ...) entspricht.
--conf
- Gibt die Konfigurationsdatei (die
LocalSettings.php
-Datei für das spezifische Wiki) an. Verwendung für Wiki-Familien.
Skriptabhängige Parameter
--quick
- Überspringung der Abzählungssequenz
--initial
- (eingeführt in 1.43) Führen Sie nach manueller Installation die erforderlichen ersten Updates mit tables-generated.sql aus
--doshared
- Aktualisiere auch gemeinsame Tabellen.
--noschema
- Alle Änderungen der Tabellenstruktur oder der Tabellenhinzufügungen werden übersprungen. Nur Datenänderungen werden vorgenommen.
--schema
- Es werden keine Schemaänderungen in der Datenbank vorgenommen, aber die Schemaänderung wird in eine separate SQL-Datei gespeichert, die ausgeführt werden kann.
- Erlaubt, "update.php" auszuführen, wenn $wgAllowSchemaUpdates auf false gesetzt ist. Dies ist nützlich für nicht-WMF-Umgebungen, in denen strenge DB-Berechtigungen Datenbankupdates erlauben (die "update.php" durchführt), aber keine Schemaänderungen (wie das Hinzufügen oder Entfernen von Tabellen oder Indexen, die "update.php" ebenfalls durchführt).
--force
- Führen Sie dieses Skript aus, auch wenn die Konfigurationsoptionen es deaktivieren.
--skip-external-dependencies
- Bei der Nutzung von composer.local.json, um Composer Erweiterungen und deren Abhängigkeiten installieren zu lassen, sehen Sie möglicherweise eine Fehlermeldung, die auf einen Unterschied zwischen der installierten und der erforderlichen Version hindeutet (z. B. "mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required"). Sie können diesen Parameter verwenden, um die Nachricht zu ignorieren und update.php unabhängig davon auszuführen.
--skip-config-validation
- (eingeführt in 1.39) Überspringt die Prüfung, ob die bestehende Konfiguration gültig ist. Ansonsten wird dieses Skript nicht ausgeführt, wenn eine ungültige Konfiguration erkannt wird.
--skip-compat-checks
- (entfernt in 1.41) Überspringt die Kompatibilitätsprüfung (Gerrit change 851684)
--nopurge
- (entfernt in 1.36) Bereinige nicht die objectcache-Tabelle. Normalerweise bereinigt
update.php
die objectcache -Tabelle (in der Regel enthält diese Parser-Cache und Nachrichten-Cache), msg_resource und msg_resource_links (diese werden für das Caching von ResourceLoader -Nachricht-Caching verwendet und werden in 1.21 und höher gelöscht) Tabellen in der Datenbank, wenn Sie diese Tabelle nicht löschen möchten, verwenden Sie die Option--nopurge
.
Siehe auch
- Handbuch:$wgDBadminuser und Handbuch:$wgDBadminpassword
- Für eine detaillierte Anleitung,
update.php
zu nutzen, siehe Handbuch:Aktualisierung , Manual:Upgrading#Command_line