maintenance/renameDbPrefix.php

   1 <?php
   2 /**
   3  * Change the prefix of database tables.
   4  * Run this script to after changing $wgDBprefix on a wiki.
   5  * The wiki will have to get downtime to do this correctly.
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  20  * http://www.gnu.org/copyleft/gpl.html
  21  *
  22  * @file
  23  * @ingroup Maintenance
  24  */
  25
  26 require_once __DIR__ . '/Maintenance.php';
  27
  28 /**
  29  * Maintenance script that changes the prefix of database tables.
  30  *
  31  * @ingroup Maintenance
  32  */
  33 class RenameDbPrefix extends Maintenance {
  34         public function __construct() {
  35                 parent::__construct();
  36                 $this->addOption( "old", "Old db prefix [0 for none]", true, true );
  37                 $this->addOption( "new", "New db prefix [0 for none]", true, true );
  38         }
  39
  40         public function getDbType() {
  41                 return Maintenance::DB_ADMIN;
  42         }
  43
  44         public function execute() {
  45                 global $wgDBname;
  46
  47                 // Allow for no old prefix
  48                 if ( $this->getOption( 'old', 0 ) === '0' ) {
  49                         $old = '';
  50                 } else {
  51                         // Use nice safe, sane, prefixes
  52                         preg_match( '/^[a-zA-Z]+_$/', $this->getOption( 'old' ), $m );
  53                         $old = $m[0] ?? false;
  54                 }
  55                 // Allow for no new prefix
  56                 if ( $this->getOption( 'new', 0 ) === '0' ) {
  57                         $new = '';
  58                 } else {
  59                         // Use nice safe, sane, prefixes
  60                         preg_match( '/^[a-zA-Z]+_$/', $this->getOption( 'new' ), $m );
  61                         $new = $m[0] ?? false;
  62                 }
  63
  64                 if ( $old === false || $new === false ) {
  65                         $this->fatalError( "Invalid prefix!" );
  66                 }
  67                 if ( $old === $new ) {
  68                         $this->output( "Same prefix. Nothing to rename!\n", true );
  69                 }
  70
  71                 $this->output( "Renaming DB prefix for tables of $wgDBname from '$old' to '$new'\n" );
  72                 $count = 0;
  73
  74                 $dbw = $this->getDB( DB_MASTER );
  75                 $res = $dbw->query( "SHOW TABLES " . $dbw->buildLike( $old, $dbw->anyString() ) );
  76                 foreach ( $res as $row ) {
  77                         // XXX: odd syntax. MySQL outputs an oddly cased "Tables of X"
  78                         // sort of message. Best not to try $row->x stuff...
  79                         $fields = get_object_vars( $row );
  80                         // Silly for loop over one field...
  81                         foreach ( $fields as $table ) {
  82                                 // $old should be regexp safe ([a-zA-Z_])
  83                                 $newTable = preg_replace( '/^' . $old . '/', $new, $table );
  84                                 $this->output( "Renaming table $table to $newTable\n" );
  85                                 $oldTableEnc = $dbw->addIdentifierQuotes( $table );
  86                                 $newTableEnc = $dbw->addIdentifierQuotes( $newTable );
  87                                 $dbw->query( "RENAME TABLE $oldTableEnc TO $newTableEnc" );
  88                         }
  89                         $count++;
  90                 }
  91                 $this->output( "Done! [$count tables]\n" );
  92         }
  93 }
  94
  95 $maintClass = RenameDbPrefix::class;
  96 require_once RUN_MAINTENANCE_IF_MAIN;