maintenance/dumpBackup.php

   1 <?php
   2 /**
   3  * Script that dumps wiki pages or logging database into an XML interchange
   4  * wrapper format for export or backup
   5  *
   6  * Copyright © 2005 Brion Vibber <brion@pobox.com>
   7  * http://www.mediawiki.org/
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License along
  20  * with this program; if not, write to the Free Software Foundation, Inc.,
  21  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  22  * http://www.gnu.org/copyleft/gpl.html
  23  *
  24  * @file
  25  * @ingroup Dump Maintenance
  26  */
  27
  28 $originalDir = getcwd();
  29
  30 $optionsWithArgs = array( 'pagelist', 'start', 'end' );
  31
  32 require_once( dirname( __FILE__ ) . '/commandLine.inc' );
  33 require_once( 'backup.inc' );
  34
  35 $dumper = new BackupDumper( $argv );
  36
  37 if ( isset( $options['quiet'] ) ) {
  38         $dumper->reporting = false;
  39 }
  40
  41 if ( isset( $options['pagelist'] ) ) {
  42         $olddir = getcwd();
  43         chdir( $originalDir );
  44         $pages = file( $options['pagelist'] );
  45         chdir( $olddir );
  46         if ( $pages === false ) {
  47                 wfDie( "Unable to open file {$options['pagelist']}\n" );
  48         }
  49         $pages = array_map( 'trim', $pages );
  50         $dumper->pages = array_filter( $pages, create_function( '$x', 'return $x !== "";' ) );
  51 }
  52
  53 if ( isset( $options['start'] ) ) {
  54         $dumper->startId = intval( $options['start'] );
  55 }
  56 if ( isset( $options['end'] ) ) {
  57         $dumper->endId = intval( $options['end'] );
  58 }
  59 $dumper->skipHeader = isset( $options['skip-header'] );
  60 $dumper->skipFooter = isset( $options['skip-footer'] );
  61 $dumper->dumpUploads = isset( $options['uploads'] );
  62
  63 $textMode = isset( $options['stub'] ) ? WikiExporter::STUB : WikiExporter::TEXT;
  64
  65 if ( isset( $options['full'] ) ) {
  66         $dumper->dump( WikiExporter::FULL, $textMode );
  67 } elseif ( isset( $options['current'] ) ) {
  68         $dumper->dump( WikiExporter::CURRENT, $textMode );
  69 } elseif ( isset( $options['stable'] ) ) {
  70         $dumper->dump( WikiExporter::STABLE, $textMode );
  71 } elseif ( isset( $options['logs'] ) ) {
  72         $dumper->dump( WikiExporter::LOGS );
  73 } else {
  74         $dumper->progress( <<<ENDS
  75 This script dumps the wiki page or logging database into an
  76 XML interchange wrapper format for export or backup.
  77
  78 XML output is sent to stdout; progress reports are sent to stderr.
  79
  80 Usage: php dumpBackup.php <action> [<options>]
  81 Actions:
  82   --full      Dump all revisions of every page.
  83   --current   Dump only the latest revision of every page.
  84   --logs      Dump all log events.
  85   --stable    Stable versions of pages?
  86   --pagelist=<file>
  87                           Where <file> is a list of page titles to be dumped
  88
  89 Options:
  90   --quiet     Don't dump status reports to stderr.
  91   --report=n  Report position and speed after every n pages processed.
  92                           (Default: 100)
  93   --server=h  Force reading from MySQL server h
  94   --start=n   Start from page_id or log_id n
  95   --end=n     Stop before page_id or log_id n (exclusive)
  96   --skip-header Don't output the <mediawiki> header
  97   --skip-footer Don't output the </mediawiki> footer
  98   --stub      Don't perform old_text lookups; for 2-pass dump
  99   --uploads   Include upload records (experimental)
 100   --conf=<file> Use the specified configuration file (LocalSettings.php)
 101
 102   --wiki=<wiki>  Only back up the specified <wiki>
 103
 104 Fancy stuff: (Works? Add examples please.)
 105   --plugin=<class>[:<file>]   Load a dump plugin class
 106   --output=<type>:<file>      Begin a filtered output stream;
 107                                                           <type>s: file, gzip, bzip2, 7zip
 108   --filter=<type>[:<options>] Add a filter on an output branch
 109
 110 ENDS
 111 );
 112 }