Manual:importDump.php

MediaWiki file: importDump.php
Location:	maintenance/
Source code:	master • 1.32.0 • 1.31.1
Classes:	BackupReader

Contents

Details

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.

Examples

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

or

php importDump.php < dumpfile.xml

Notes

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.

Troubleshooting

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

See also

• Importing XML dumps for more detailed instructions.
• Manual:dumpBackup.php for instructions on creating a dump.

External links

• importDump.php source code on MediaWiki master.

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 --user-prefix="" when importing files.