Manual:importDump.php

Other languages:

MediaWiki file: importDump.php
Location:	maintenance/
Source code:	master • 1.36.2 • 1.35.4
Classes:	BackupReader

DetailsEdit

importDump.php file is a maintenance script to import XML dump files into the current wiki. It reads pages from an XML file as produced from Special:Export or dumpBackup.php , and saves them into the current wiki.

In case you get an error "failed to open stream: No such file or directory", make sure that the specified file does exist and that PHP has access to it.

ExamplesEdit

php importDump.php --conf ../LocalSettings.php /path_to/dumpfile.xml.gz

or

php importDump.php < dumpfile.xml

OptionsEdit

Option/Parameter	Description
--report	Report position and speed after every n pages processed.
--namespaces	Import only the pages from namespaces belonging to the list of pipe-separated namespace names or namespace indexes.
--dry-run	Parse dump without actually importing pages.
--debug	Output extra verbose debug information.
--uploads	Process file upload data if included (experimental).
--no-updates	Disable link table updates. Is faster but leaves the wiki in an inconsistent state. Run rebuildall.php after the import to correct the link table.
--image-base-path	Import files from a specified path.
--skip-to	Start from the given page number, by skipping first n-1 pages.
--username-prefix	Adds a prefix to usernames. Due to this bug it may be necessary to specify `--username-prefix=""` when importing files.

NotesEdit

For very large data sets, importDump.php may be slow; there are alternate methods which can be much faster for full site restoration, see Manual:Importing XML dumps .

Since MediaWiki 1.29 (task T144600), importDump.php doesn't update statistics. You should run initSiteStats.php manually after the import to update page and revision counts.

TroubleshootingEdit

If errors occur when importing files, it may be necessary to use the --username-prefix option.