3 * Copyright (C) 2005 Brion Vibber <brion@pobox.com>
4 * http://www.mediawiki.org/
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19 * http://www.gnu.org/copyleft/gpl.html
21 * @addtogroup SpecialPage
24 $originalDir = getcwd();
26 $optionsWithArgs = array( 'pagelist', 'start', 'end' );
28 require_once( 'commandLine.inc' );
29 require_once( 'backup.inc' );
31 $dumper = new BackupDumper( $argv );
33 if( isset( $options['quiet'] ) ) {
34 $dumper->reporting
= false;
37 if ( isset( $options['pagelist'] ) ) {
39 chdir( $originalDir );
40 $pages = file( $options['pagelist'] );
42 if ( $pages === false ) {
43 wfDie( "Unable to open file {$options['pagelist']}\n" );
45 $pages = array_map( 'trim', $pages );
46 $dumper->pages
= array_filter( $pages, create_function( '$x', 'return $x !== "";' ) );
49 if( isset( $options['start'] ) ) {
50 $dumper->startId
= intval( $options['start'] );
52 if( isset( $options['end'] ) ) {
53 $dumper->endId
= intval( $options['end'] );
55 $dumper->skipHeader
= isset( $options['skip-header'] );
56 $dumper->skipFooter
= isset( $options['skip-footer'] );
58 $textMode = isset( $options['stub'] ) ? WikiExporter
::STUB
: WikiExporter
::TEXT
;
60 if( isset( $options['full'] ) ) {
61 $dumper->dump( WikiExporter
::FULL
, $textMode );
62 } elseif( isset( $options['current'] ) ) {
63 $dumper->dump( WikiExporter
::CURRENT
, $textMode );
65 $dumper->progress( <<<END
66 This script dumps the wiki page database into an XML interchange wrapper
67 format for export or backup.
69 XML output is sent to stdout; progress reports are sent to stderr.
71 Usage: php dumpBackup.php <action> [<options>]
73 --full Dump complete history of every page.
74 --current Includes only the latest revision of each page.
77 --quiet Don't dump status reports to stderr.
78 --report=n Report position and speed after every n pages processed.
80 --server=h Force reading from MySQL server h
81 --start=n Start from page_id n
82 --end=n Stop before page_id n (exclusive)
83 --skip-header Don't output the <mediawiki> header
84 --skip-footer Don't output the </mediawiki> footer
85 --stub Don't perform old_text lookups; for 2-pass dump
88 --plugin=<class>[:<file>] Load a dump plugin class
89 --output=<type>:<file> Begin a filtered output stream;
90 <type>s: file, gzip, bzip2, 7zip
91 --filter=<type>[:<options>] Add a filter on an output branch