Manual:DumpBackup.php/de

Details
dumpBackup.php file erstellt einen XML-Dump für Export oder Backup. XML-Dumps enthalten die Wiki-Inhalte (Wiki-Seiten mit Revisionen) ohne die Wiki-spezifischen Daten. DumpBackup.php erstellt kein vollständiges Backup der Wiki-Datenbank, der Dump enthält weder Benutzerkonten, Bilder, Bearbeitungsprotokolle oder gelöschte Revisionen usw. Sobald der Dump abgeschlossen ist, kannst du den XML-Dump importieren.

Beispiele


Allgemeine Beispiele
Du musst einen Dateinamen für den Datendump wählen.

Zum Beispiel speichert der Benutzer hier den gesamten Revisionsverlauf (--full) in der Datei ' ':


 * Weitere Details zu dieser beispielhaften dump.xml findest du unter 'Detailliertes Beispiel'.

Du kannst den Datendump auf einen bestimmten Namensraum begrenzen. Im folgenden Beispiel erhältst du nur Vorlagen mit der jeweils aktuellen Revision:

oder Vorlagen mit allen Revisionen:

Mehrere Namenräume einschließen:

Beispielverwendung eines Plugins:

 php dumpBackup.php \ --plugin=AbstractFilter:extensions/ActiveAbstract/AbstractFilter.php \ --current \ --output=gzip:/dumps/abstract.xml.gz \ --filter=namespace:NS_MAIN \ --filter=noredirect \ --filter=abstract \ --quiet

oder

 php dumpBackup.php \ --plugin=MathMLFilter:../extensions/MathSearch/maintenance/MathMLFilter.php \ --current \ --filter=namespace:NS_MAIN \ --filter=mathml \ --quiet

Die Option  kann mit  genutzt werden.

Um Dateien mit   einzuschließen:

 php dumpBackup.php \ --full \ --include-files \ --uploads \ --output=gzip:/dumps/abstract.xml.gz \ --quiet

Auch die Option   muss hier benutzt werden, da ansonsten keine Dateien eingeschlossen werden.



Detailiertes Beispiel
In diesem Beispiel ist der grüne Text der Text, den du eingibst.


 * 1) Umleitung (redirect) in den Ordner 'maintenance' mit cd. Der genaue Speicherort Ihres Ordner 'maintenance' weicht wahrscheinlich von dem Beispiel ab.
 * 2) Gib  php dumpBackup.php --full > dump.xml  ein und drücke Return. Das erzeugt eine Liste ähnlich der im Beispiel.

Die neue XML-Datei wird im Ordner 'maintenance' erzeugt. Möglicherweise musst du in SCP einen Refresh durchführen, um die XML-Datei zu sehen.

Optionen
Ab MediaWiki :

 This script dumps the wiki page or logging database into an XML interchange wrapper format for export or backup.

XML output is sent to stdout; progress reports are sent to stderr.

Usage: php dumpBackup.php [ ] Actions: --full     Dump all revisions of every page. --current  Dump only the latest revision of every page. --logs     Dump all log events. --stable   Stable versions of pages? --pagelist= Where is a list of page titles to be dumped --revrange Dump specified range of revisions, requires revstart and revend options. Options: --quiet    Don't dump status reports to stderr. --report=n Report position and speed after every n pages processed. (Default: 100) --server=h Force reading from MySQL server h  --start=n   Start from page_id or log_id n  --end=n     Stop before page_id or log_id n (exclusive) --revstart=n Start from rev_id n  --revend=n    Stop before rev_id n (exclusive) --skip-header Don't output the header --skip-footer Don't output the footer --stub     Don't perform old_text lookups; for 2-pass dump --uploads  Include upload records without files --include-files Include files within the XML stream --conf= Use the specified configuration file (LocalSettings.php)

--wiki= Only back up the specified

Fancy stuff: (Works? Add examples please.) --plugin= [: ]  Load a dump plugin class --output= :     Begin a filtered output stream; s: file, gzip, bzip2, 7zip --filter= [: ] Add a filter on an output branch --7ziplevel=<0-10>         Level of 7zip compression (0 - no compression is default)

Dieses Skript stellt eine Verbindung zur Datenbank her mit dem Benutzernamen und Kennwort, die normalerweise in durch  und  definiert sind. Üblicherweise ist $wgDBadminuser ein Benutzer mit mehr Rechten als, aber zum Ausführen von  sind keine zusätzlichen Rechte erforderlich, sodass die Benutzernamen und Kennwörter dieselben sein können. Wenn die Variablen nicht gesetzt sind, schlägt  fehl beim Versuch, sich mit der Datenbank zu verbinden:

 $ php dumpBackup.php --full DB connection error: Unknown error

Anmerkungen
Die XML-Datei wird an die Standardausgabe (stdout) gesendet, und Fortschrittsberichte werden an die Standardfehlerausgabe (stderr) gesendet. Beide werden standardmäßig auf der Konsole ausgegeben. Wenn du das Skript von der Shell aus aufrufst, sollten beide Ausgaben standardmäßig an die Shell gesendet werden, was bedeutet: Du solltest "informative" Ausgaben und Fehler direkt auf dem Bildschirm sehen.



Fehlermeldungen
Wenn du dich nicht im richtigen Ordner befindest, erhältst du die Meldung:

 No input file specified.

Das dumpBackup-Skript gibt die Meldung „ “ aus, wenn der Parameter nach   als 0 oder nicht als Zahl ausgewertet wird. Die Lösung besteht darin, dumpBackup ohne die Option  auszuführen; dumpBackup druckt dann nach jeweils 100 verarbeiteten Seiten eine Statuszeile.



Empfohlene Konfigurationseinstellungen

 * sollte auf 0 gesetzt werden, um zu vermeiden, alle Revisionen in den Objektcache einzufügen. Die meisten alten Revisionen profitieren nicht davon, im Cache gespeichert zu werden, da ein Leser normalerweise keine zufälligen alten Revisionen von Seiten sieht.



Siehe auch

 * Dumps/Software dependencies
 * Beispiele und Wrapper-Skripte
 * xmldumps-backup enthält Skripte, die von der Wikimedia Foundation verwendet werden, Python-Skripte sind dokumentiert; siehe auch wikitech:Category:Dumps (vorerst einige Beispiele unter Dumps/Rerunning_a_job).
 * Wikia WikiFactory/Dumps
 * Beispiele und Wrapper-Skripte
 * xmldumps-backup enthält Skripte, die von der Wikimedia Foundation verwendet werden, Python-Skripte sind dokumentiert; siehe auch wikitech:Category:Dumps (vorerst einige Beispiele unter Dumps/Rerunning_a_job).
 * Wikia WikiFactory/Dumps