Jump to content

Podręcznik:DumpBackup.php

From mediawiki.org
This page is a translated version of the page Manual:DumpBackup.php and the translation is 68% complete.
Outdated translations are marked like this.

Szczegóły

Plik dumpBackup.php tworzy zrzut XML, który może służyć do eksportu lub jako kopia zapasowa. Zrzuty XML zawierają zawartość wiki (strony wiki wraz z wszystkimi ich wersjami), bez danych związanych ze stroną. DumpBackup.php does not create a full backup of the wiki database, the dump does not contain user accounts, images, deleted revisions, etc.[1] Po zakończonym tworzeniu zrzutu, możesz zaimportować zrzut XML.

Przykłady

General examples

Musisz nadać nazwę zrzutu danych.

Na przykład ten użytkownik zapisuje całą historię wersji ( --full) do pliku o nazwie --full:

php dumpBackup.php --full > pagedump.xml

You can also include the uploaded files by doing:

php dumpBackup.php --full --include-files --uploads > page-and-filedump.xml
Po więcej szczegółów o tym przykładzie z dump.xml, zobacz Szczegółowy przykład niżej.

Możesz ograniczyć zrzut danych do jednej przestrzeni nazw. W tym przykładzie są to tylko szablony:

php dumpBackup.php --current --quiet --filter=namespace:10 > templates.xml

or templates with all of their revisions:

php dumpBackup.php --full --quiet --filter=namespace:10 > templates.xml

Aby dołączyć więcej przestrzeni nazw:

php dumpBackup.php --current --quiet --filter=namespace:10,11 > templates_plus_template_talk.xml

To also include files when filtering by certain namespaces:

php dumpBackup.php --current --quiet --filter=namespace:0,1,6 --include-files --uploads > main_plus_talk_plus_files.xml

Przykład wykorzystania wtyczki:

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

lub

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

Opcja --stub może być użyta z dumpTextPass.php .

Z użyciem --include-files:

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

Musi także zostać użyta opcja --uploads. Inaczej nie będą dołączone żadne pliki.

Szczegółowy przykład

W podanym przykładzie zielony tekst to wpisywany tekst.

  1. Przejdź do katalogu maintenance komendą cd. Lokalizacja Twojego katalogu maintenance może się różnić od tego przykładu.
  2. Wpisz php dumpBackup.php --full > /var/tmp/dump.xml i wciśnij enter. Zostanie utworzona długa lista kodu, podobna do poniższego przykładu.

user@server:/$ cd /var/www/html/wiki/w/maintenance

user@server:/var/www/html/wiki/w/maintenance$ php dumpBackup.php --full > /var/tmp/dump.xml

2014-08-15 09:54:08: my_wiki-finddcjobs (ID 23578) 0 pages (0.0|0.0/sec all|curr), 100 revs (404.7|404.7/sec all|curr), ETA 2014-08-15 09:54:11 [max 1143]

2014-08-15 09:54:08: my_wiki-finddcjobs (ID 23578) 0 pages (0.0|0.0/sec all|curr), 200 revs (499.7|652.8/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:08: my_wiki-finddcjobs (ID 23578) 10 pages (19.2|83.8/sec all|curr), 300 revs (577.4|838.3/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:08: my_wiki-finddcjobs (ID 23578) 17 pages (24.1|91.4/sec all|curr), 400 revs (567.0|537.9/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:09: my_wiki-finddcjobs (ID 23578) 18 pages (15.6|40.2/sec all|curr), 500 revs (433.4|223.1/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:09: my_wiki-finddcjobs (ID 23578) 23 pages (15.4|66.8/sec all|curr), 600 revs (400.6|290.5/sec all|curr), ETA 2014-08-15 09:54:11 [max 1143]

2014-08-15 09:54:09: my_wiki-finddcjobs (ID 23578) 59 pages (36.0|412.4/sec all|curr), 700 revs (426.6|699.0/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:09: my_wiki-finddcjobs (ID 23578) 62 pages (36.2|856.3/sec all|curr), 800 revs (466.9|1381.2/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:10: my_wiki-finddcjobs (ID 23578) 89 pages (48.8|798.3/sec all|curr), 900 revs (493.2|896.9/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:10: my_wiki-finddcjobs (ID 23578) 120 pages (62.4|1224.2/sec all|curr), 1000 revs (520.1|1020.2/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

2014-08-15 09:54:10: my_wiki-finddcjobs (ID 23578) 124 pages (59.0|697.5/sec all|curr), 1100 revs (523.7|562.5/sec all|curr), ETA 2014-08-15 09:54:10 [max 1143]

user@server:/var/www/html/wiki/w/maintenance$

Nowy plik file zostanie utworzony w folderze maintenance (być może będziesz musiał odświeżyć przeglądarkę plików, aby zobaczyć ten plik).

Opcje

As of MediaWiki 1.39:

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.

WARNING: this is not a full database dump! It is merely for public export of your wiki. For full backup, see our online help at: https://www.mediawiki.org/wiki/Backup

Usage: php dumpBackup.php [--7ziplevel|--conf|--current|--dbgroupdefault|--dbpass|--dbuser|--end|--filter|--full|--globals|--help|--include-files|--logs|--memory-limit|--namespaces|--orderrevs|--output|--pagelist|--plugin|--profiler|--quiet|--report|--revend|--revrange|--revstart|--schema-version|--server|--skip-footer|--skip-header|--stable|--start|--stub|--uploads|--wiki]

Generic maintenance parameters:
    --help (-h): Display this help message
    --quiet (-q): Whether to suppress non-error output

Script dependent parameters:
    --dbgroupdefault: The default DB group to use.
    --dbpass: The password to use for this script
    --dbuser: The DB user to use for this script

Script specific parameters:
    --7ziplevel: 7zip compression level for all 7zip outputs. Used for -mx option to 7za command.
    --conf: Location of LocalSettings.php, if not default
    --current: Dump only the latest revision of every page.
    --end: Stop before page_id or log_id n (exclusive)
    --filter: Add a filter on an output branch. Specify as <type>[:<options>]. <types>s: latest, notalk, namespace
    --full: Dump all revisions of every page
    --globals: Output globals at the end of processing for debugging
    --include-files: Include files within the XML stream
    --logs: Dump all log events
    --memory-limit: Set a specific memory limit for the script, "max" for no limit or "default" to avoid changing it
    --namespaces: Limit to this comma-separated list of namespace numbers
    --orderrevs: Dump revisions in ascending revision order (implies dump of a range of pages)
    --output (-o): Begin a filtered output stream; Specify as <type>:<file>. <type>s: file, gzip, bzip2, 7zip, dbzip2, lbzip2
    --pagelist: Dump only pages included in the file
    --plugin: Load a dump plugin class. Specify as <class>[:<file>].
    --profiler: Profiler output format (usually "text")
    --report: Report position and speed after every n pages processed. Default: 100.
    --revend: Stop before rev_id n (exclusive)
    --revrange: Dump range of revisions specified by revstart and revend parameters
    --revstart: Start from rev_id
    --schema-version: Schema version to use for output. Default: 0.11
    --server: The protocol and server name to use in URLs, e.g. https://en.wikipedia.org. This is sometimes necessary because server name detection may fail in command line scripts.
    --skip-footer: Don't output the </mediawiki> footer
    --skip-header: Don't output the <mediawiki> header
    --stable: Dump stable versions of pages
    --start: Start from page_id or log_id
    --stub: Don't perform old_text lookups; for 2-pass dump
    --uploads: Include upload records without files
    --wiki: For specifying the wiki ID

Ten skrypt łączy się z baza danych korzystając z nazwy użytkownika i hasła zdefiniowanych przez $wgDBadminuser oraz $wgDBadminpassword , które zazwyczaj ustawia się w LocalSettings.php . Zazwyczaj $wgDBadminuser jest użytkownikiem z większymi uprawnieniami niż określony w $wgDBuser , ale do uruchomienia dumpBackup.php nie są wymagane dodatkowe uprawnienia, więc nazwy użytkowników i hasła mogą być takie same. Jeżeli te zmienne nie zostaną ustawione, dumpBackup.php pokaże błąd podczas próby połączenia się z bazą danych:

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

Uwagi

Plik XML jest wysyłany do standardowego wyjścia (stdout); raporty o postępie są wysyłane do standardowego strumienia błędów (stderr). Są to domyślne urządzenia dla wyjścia i wyjścia błędów. Kiedy wywołujesz ten skrypt z powłoki, to obydwa wyjścia zostaną domyślnie wysłane do powłoki, co znaczy: Zobaczysz wyjścia z „informacjami“ i błędami bezpośrednio na ekranie.

Komunikaty błędów

Jeżeli nie jesteś we właściwym folderze, otrzymasz następujący komunikat:

No input file specified.

Skrypt dumpBackup wyświetli "Warning: Division by zero in [DIRECTORY]/maintenance/backup.inc" gdy parametr za „--report“ będzie wynosił 0 lub nie będzie liczbą. Poprawką jest uruchomienie dumpBackup bez opcji „--report“; wtedy dumpBackup będzie wyświetlać linię statusu co każde 100 przetworzonych stron.

  • $wgRevisionCacheExpiry should be set to 0, to avoid inserting all revisions into the object cache. Most of them won't benefit from being stored in the cache because your readers normally won't view random old revisions of pages on your wiki.

Zobacz też

Przypisy

  1. DumpBackup.php creates an XML interchange wrapper.