maintenance/update.php

   1 <?php
   2 /**
   3  * Run all updaters.
   4  *
   5  * This is used when the database schema is modified and we need to apply patches.
   6  * It is kept compatible with php 4 parsing so that it can give out a meaningful error.
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License along
  19  * with this program; if not, write to the Free Software Foundation, Inc.,
  20  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  21  * http://www.gnu.org/copyleft/gpl.html
  22  *
  23  * @file
  24  * @todo document
  25  * @ingroup Maintenance
  26  */
  27
  28 if ( !function_exists( 'version_compare' ) || ( version_compare( phpversion(), '5.3.2' ) < 0 ) ) {
  29         require dirname( __FILE__ ) . '/../includes/PHPVersionError.php';
  30         wfPHPVersionError( 'cli' );
  31 }
  32
  33 $wgUseMasterForMaintenance = true;
  34 require_once __DIR__ . '/Maintenance.php';
  35
  36 /**
  37  * Maintenance script to run database schema updates.
  38  *
  39  * @ingroup Maintenance
  40  */
  41 class UpdateMediaWiki extends Maintenance {
  42         function __construct() {
  43                 parent::__construct();
  44                 $this->mDescription = "MediaWiki database updater";
  45                 $this->addOption( 'skip-compat-checks', 'Skips compatibility checks, mostly for developers' );
  46                 $this->addOption( 'quick', 'Skip 5 second countdown before starting' );
  47                 $this->addOption( 'doshared', 'Also update shared tables' );
  48                 $this->addOption( 'nopurge', 'Do not purge the objectcache table after updates' );
  49                 $this->addOption( 'noschema', 'Only do the updates that are not done during schema updates' );
  50                 $this->addOption( 'schema', 'Output SQL to do the schema updates instead of doing them.  Works even when $wgAllowSchemaUpdates is false', false, true );
  51                 $this->addOption( 'force', 'Override when $wgAllowSchemaUpdates disables this script' );
  52         }
  53
  54         function getDbType() {
  55                 /* If we used the class constant PHP4 would give a parser error here */
  56                 return 2 /* Maintenance::DB_ADMIN */;
  57         }
  58
  59         function compatChecks() {
  60                 $test = new PhpXmlBugTester();
  61                 if ( !$test->ok ) {
  62                         $this->error(
  63                                 "Your system has a combination of PHP and libxml2 versions which is buggy\n" .
  64                                 "and can cause hidden data corruption in MediaWiki and other web apps.\n" .
  65                                 "Upgrade to PHP 5.2.9 or later and libxml2 2.7.3 or later!\n" .
  66                                 "ABORTING (see http://bugs.php.net/bug.php?id=45996).\n",
  67                                 true );
  68                 }
  69
  70                 $test = new PhpRefCallBugTester;
  71                 $test->execute();
  72                 if ( !$test->ok ) {
  73                         $ver = phpversion();
  74                         $this->error(
  75                                 "PHP $ver is not compatible with MediaWiki due to a bug involving\n" .
  76                                 "reference parameters to __call. Upgrade to PHP 5.3.2 or higher, or \n" .
  77                                 "downgrade to PHP 5.3.0 to fix this.\n" .
  78                                 "ABORTING (see http://bugs.php.net/bug.php?id=50394 for details)\n",
  79                                 true );
  80                 }
  81         }
  82
  83         function execute() {
  84                 global $wgVersion, $wgTitle, $wgLang, $wgAllowSchemaUpdates;
  85
  86                 if ( !$wgAllowSchemaUpdates && !( $this->hasOption( 'force' ) || $this->hasOption( 'schema' ) || $this->hasOption( 'noschema' ) ) ) {
  87                         $this->error( "Do not run update.php on this wiki. If you're seeing this you should\n"
  88                                 . "probably ask for some help in performing your schema updates or use\n"
  89                                 . "the --noschema and --schema options to get an SQL file for someone\n"
  90                                 . "else to inspect and run.\n\n"
  91                                 . "If you know what you are doing, you can continue with --force\n", true );
  92                 }
  93
  94                 $this->fileHandle = null;
  95                 if ( substr( $this->getOption( 'schema' ), 0, 2 ) === "--" ) {
  96                         $this->error( "The --schema option requires a file as an argument.\n", true );
  97                 } elseif ( $this->hasOption( 'schema' ) ) {
  98                         $file = $this->getOption( 'schema' );
  99                         $this->fileHandle = fopen( $file, "w" );
 100                         if ( $this->fileHandle === false ) {
 101                                 $err = error_get_last();
 102                                 $this->error( "Problem opening the schema file for writing: $file\n\t{$err['message']}", true );
 103                         }
 104                 }
 105
 106                 $wgLang = Language::factory( 'en' );
 107                 $wgTitle = Title::newFromText( "MediaWiki database updater" );
 108
 109                 $this->output( "MediaWiki {$wgVersion} Updater\n\n" );
 110
 111                 wfWaitForSlaves( 5 ); // let's not kill databases, shall we? ;) --tor
 112
 113                 if ( !$this->hasOption( 'skip-compat-checks' ) ) {
 114                         $this->compatChecks();
 115                 } else {
 116                         $this->output( "Skipping compatibility checks, proceed at your own risk (Ctrl+C to abort)\n" );
 117                         wfCountdown( 5 );
 118                 }
 119
 120                 # Attempt to connect to the database as a privileged user
 121                 # This will vomit up an error if there are permissions problems
 122                 $db = wfGetDB( DB_MASTER );
 123
 124                 $this->output( "Going to run database updates for " . wfWikiID() . "\n" );
 125                 if ( $db->getType() === 'sqlite' ) {
 126                         $this->output( "Using SQLite file: '{$db->mDatabaseFile}'\n" );
 127                 }
 128                 $this->output( "Depending on the size of your database this may take a while!\n" );
 129
 130                 if ( !$this->hasOption( 'quick' ) ) {
 131                         $this->output( "Abort with control-c in the next five seconds (skip this countdown with --quick) ... " );
 132                         wfCountDown( 5 );
 133                 }
 134
 135                 $shared = $this->hasOption( 'doshared' );
 136
 137                 $updates = array( 'core', 'extensions' );
 138                 if ( !$this->hasOption( 'schema' ) ) {
 139                         if ( $this->hasOption( 'noschema' ) ) {
 140                                 $updates[] = 'noschema';
 141                         }
 142                         $updates[] = 'stats';
 143
 144                         if ( !$this->hasOption( 'nopurge' ) ) {
 145                                 $updates[] = 'purge';
 146                         }
 147                 }
 148
 149                 $updater = DatabaseUpdater::newForDb( $db, $shared, $this );
 150                 $updater->doUpdates( $updates );
 151
 152                 foreach ( $updater->getPostDatabaseUpdateMaintenance() as $maint ) {
 153                         $child = $this->runChild( $maint );
 154
 155                         // LoggedUpdateMaintenance is checking the updatelog itself
 156                         $isLoggedUpdate = is_a( $child, 'LoggedUpdateMaintenance' );
 157
 158                         if ( !$isLoggedUpdate && $updater->updateRowExists( $maint ) ) {
 159                                 continue;
 160                         }
 161
 162                         $child = $this->runChild( $maint );
 163                         $child->execute();
 164                         if ( !$isLoggedUpdate ) {
 165                                 $updater->insertUpdateRow( $maint );
 166                         }
 167                 }
 168
 169                 if ( !$this->hasOption( 'nopurge' ) ) {
 170                         $updater->purgeCache();
 171                 }
 172
 173                 $this->output( "\nDone.\n" );
 174         }
 175
 176         function afterFinalSetup() {
 177                 global $wgLocalisationCacheConf;
 178
 179                 # Don't try to access the database
 180                 # This needs to be disabled early since extensions will try to use the l10n
 181                 # cache from $wgExtensionFunctions (bug 20471)
 182                 $wgLocalisationCacheConf = array(
 183                         'class' => 'LocalisationCache',
 184                         'storeClass' => 'LCStore_Null',
 185                         'storeDirectory' => false,
 186                         'manualRecache' => false,
 187                 );
 188         }
 189 }
 190
 191 $maintClass = 'UpdateMediaWiki';
 192 require_once RUN_MAINTENANCE_IF_MAIN;