| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/wiki/maintenance/ |
Upload File : |
<?php
/**
* Take page text out of an XML dump file and perform some operation on it.
* Used as a base class for CompareParsers.
* We implement below the simple task of searching inside a dump.
*
* Copyright © 2011 Platonides
* https://www.mediawiki.org/
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
* @ingroup Maintenance
*/
use MediaWiki\Content\ContentHandler;
use MediaWiki\MainConfigNames;
use MediaWiki\Maintenance\Maintenance;
use MediaWiki\Permissions\UltimateAuthority;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\Settings\SettingsBuilder;
use MediaWiki\Title\Title;
use MediaWiki\User\User;
// @codeCoverageIgnoreStart
require_once __DIR__ . '/Maintenance.php';
// @codeCoverageIgnoreEnd
/**
* Base class for iterating over a dump.
*
* @ingroup Maintenance
*/
abstract class DumpIterator extends Maintenance {
/** @var int */
private $count = 0;
/** @var float */
private $startTime;
/** @var string|null|false */
private $from;
public function __construct() {
parent::__construct();
$this->addDescription( 'Does something with a dump' );
$this->addOption( 'file', 'File with text to run.', false, true );
$this->addOption( 'dump', 'XML dump to execute all revisions.', false, true );
$this->addOption( 'from', 'Article from XML dump to start from.', false, true );
}
public function execute() {
if ( !( $this->hasOption( 'file' ) xor $this->hasOption( 'dump' ) ) ) {
$this->fatalError( "You must provide a file or dump" );
}
$this->checkOptions();
if ( $this->hasOption( 'file' ) ) {
$file = $this->getOption( 'file' );
$revision = new WikiRevision();
$text = file_get_contents( $file );
$title = Title::newFromText( rawurldecode( basename( $file, '.txt' ) ) );
$revision->setTitle( $title );
$content = ContentHandler::makeContent( $text, $title );
$revision->setContent( SlotRecord::MAIN, $content );
$this->from = false;
$this->handleRevision( $revision );
return;
}
$this->startTime = microtime( true );
if ( $this->getOption( 'dump' ) == '-' ) {
$source = new ImportStreamSource( $this->getStdin() );
} else {
$this->fatalError( "Sorry, I don't support dump filenames yet. "
. "Use - and provide it on stdin on the meantime." );
}
$user = User::newSystemUser( User::MAINTENANCE_SCRIPT_USER, [ 'steal' => true ] );
$importer = $this->getServiceContainer()
->getWikiImporterFactory()
->getWikiImporter( $source, new UltimateAuthority( $user ) );
$importer->setRevisionCallback(
[ $this, 'handleRevision' ] );
$importer->setNoticeCallback( static function ( $msg, $params ) {
echo wfMessage( $msg, $params )->text() . "\n";
} );
$this->from = $this->getOption( 'from', null );
$this->count = 0;
$importer->doImport();
$this->conclusions();
$delta = microtime( true ) - $this->startTime;
$this->error( "Done {$this->count} revisions in " . round( $delta, 2 ) . " seconds " );
if ( $delta > 0 ) {
$this->error( round( $this->count / $delta, 2 ) . " pages/sec" );
}
# Perform the memory_get_peak_usage() when all the other data has been
# output so there's no damage if it dies. It is only available since
# 5.2.0 (since 5.2.1 if you haven't compiled with --enable-memory-limit)
$this->error( "Memory peak usage of " . memory_get_peak_usage() . " bytes\n" );
}
public function finalSetup( SettingsBuilder $settingsBuilder ) {
parent::finalSetup( $settingsBuilder );
if ( $this->getDbType() == Maintenance::DB_NONE ) {
// TODO: Allow hooks to be registered via SettingsBuilder as well!
// This matches the idea of unifying SettingsBuilder with ExtensionRegistry.
// phpcs:disable MediaWiki.Usage.DeprecatedGlobalVariables.Deprecated$wgHooks
global $wgHooks;
$wgHooks['InterwikiLoadPrefix'][] = 'DumpIterator::disableInterwikis';
$settingsBuilder->putConfigValues( [
MainConfigNames::UseDatabaseMessages => false,
MainConfigNames::LocalisationCacheConf => [ 'storeClass' => LCStoreNull::class ],
] );
}
}
public static function disableInterwikis( string $prefix, array &$data ): bool {
# Title::newFromText will check on each namespaced article if it's an interwiki.
# We always answer that it is not.
return false;
}
/**
* Callback function for each revision, child classes should override
* processRevision instead.
* @param WikiRevision $rev
*/
public function handleRevision( $rev ) {
$title = $rev->getTitle();
if ( !$title ) {
$this->error( "Got bogus revision with null title!" );
return;
}
$this->count++;
if ( $this->from !== false ) {
if ( $this->from != $title ) {
return;
}
$this->output( "Skipped " . ( $this->count - 1 ) . " pages\n" );
$this->count = 1;
$this->from = null;
}
$this->processRevision( $rev );
}
/**
* Stub function for processing additional options
*/
public function checkOptions() {
}
/**
* Stub function for giving data about what was computed
*/
public function conclusions() {
}
/**
* Core function which does whatever the maintenance script is designed to do
*/
abstract public function processRevision( WikiRevision $rev );
}
/**
* Maintenance script that runs a regex in the revisions from a dump.
*
* @ingroup Maintenance
*/
class SearchDump extends DumpIterator {
public function __construct() {
parent::__construct();
$this->addDescription( 'Runs a regex in the revisions from a dump' );
$this->addOption( 'regex', 'Searching regex', true, true );
}
/** @inheritDoc */
public function getDbType() {
return Maintenance::DB_NONE;
}
public function processRevision( WikiRevision $rev ) {
if ( preg_match( $this->getOption( 'regex' ), $rev->getContent()->getTextForSearchIndex() ) ) {
$this->output( $rev->getTitle() . " matches at edit from " . $rev->getTimestamp() . "\n" );
}
}
}
// @codeCoverageIgnoreStart
$maintClass = SearchDump::class;
require_once RUN_MAINTENANCE_IF_MAIN;
// @codeCoverageIgnoreEnd