maintenance/dumpBackup.php

   1 <?php
   2 /**
   3  * Copyright (C) 2005 Brion Vibber <brion@pobox.com>
   4  * http://www.mediawiki.org/
   5  *
   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.
  10  *
  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.
  15  *
  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
  20  *
  21  * @file
  22  * @ingroup Dump Maintenance
  23  */
  24
  25 $originalDir = getcwd();
  26
  27 $optionsWithArgs = array( 'pagelist', 'start', 'end' );
  28
  29 require_once( 'commandLine.inc' );
  30 require_once( 'backup.inc' );
  31
  32 $dumper = new BackupDumper( $argv );
  33
  34 if( isset( $options['quiet'] ) ) {
  35         $dumper->reporting = false;
  36 }
  37
  38 if ( isset( $options['pagelist'] ) ) {
  39         $olddir = getcwd();
  40         chdir( $originalDir );
  41         $pages = file( $options['pagelist'] );
  42         chdir( $olddir );
  43         if ( $pages === false ) {
  44                 wfDie( "Unable to open file {$options['pagelist']}\n" );
  45         }
  46         $pages = array_map( 'trim', $pages );
  47         $dumper->pages = array_filter( $pages, create_function( '$x', 'return $x !== "";' ) );
  48 }
  49
  50 if( isset( $options['start'] ) ) {
  51         $dumper->startId = intval( $options['start'] );
  52 }
  53 if( isset( $options['end'] ) ) {
  54         $dumper->endId = intval( $options['end'] );
  55 }
  56 $dumper->skipHeader = isset( $options['skip-header'] );
  57 $dumper->skipFooter = isset( $options['skip-footer'] );
  58 $dumper->dumpUploads = isset( $options['uploads'] );
  59
  60 $textMode = isset( $options['stub'] ) ? WikiExporter::STUB : WikiExporter::TEXT;
  61
  62 if( isset( $options['full'] ) ) {
  63         $dumper->dump( WikiExporter::FULL, $textMode );
  64 } elseif( isset( $options['current'] ) ) {
  65         $dumper->dump( WikiExporter::CURRENT, $textMode );
  66 } else {
  67         $dumper->progress( <<<ENDS
  68 This script dumps the wiki page database into an XML interchange wrapper
  69 format for export or backup.
  70
  71 XML output is sent to stdout; progress reports are sent to stderr.
  72
  73 Usage: php dumpBackup.php <action> [<options>]
  74 Actions:
  75   --full      Dump complete history of every page.
  76   --current   Includes only the latest revision of each page.
  77
  78 Options:
  79   --quiet     Don't dump status reports to stderr.
  80   --report=n  Report position and speed after every n pages processed.
  81               (Default: 100)
  82   --server=h  Force reading from MySQL server h
  83   --start=n   Start from page_id n
  84   --end=n     Stop before page_id n (exclusive)
  85   --skip-header Don't output the <mediawiki> header
  86   --skip-footer Don't output the </mediawiki> footer
  87   --stub      Don't perform old_text lookups; for 2-pass dump
  88   --uploads   Include upload records (experimental)
  89
  90 Fancy stuff:
  91   --plugin=<class>[:<file>]   Load a dump plugin class
  92   --output=<type>:<file>      Begin a filtered output stream;
  93                               <type>s: file, gzip, bzip2, 7zip
  94   --filter=<type>[:<options>] Add a filter on an output branch
  95
  96 ENDS
  97 );
  98 }
  99
 100