RevisionDeleter.php

Go to the documentation of this file.

<?php
use MediaWiki\Revision\RevisionRecord;
 
class RevisionDeleter {
    private const ALLOWED_TYPES = [
        'revision' => RevDelRevisionList::class,
        'archive' => RevDelArchiveList::class,
        'oldimage' => RevDelFileList::class,
        'filearchive' => RevDelArchivedFileList::class,
        'logging' => RevDelLogList::class,
    ];
 
    private const DEPRECATED_TYPE_MAP = [
        'oldid' => 'revision',
        'artimestamp' => 'archive',
        'oldimage' => 'oldimage',
        'fileid' => 'filearchive',
        'logid' => 'logging',
    ];
 
    public static function getTypes() {
        return array_keys( self::ALLOWED_TYPES );
    }
 
    public static function getCanonicalTypeName( $typeName ) {
        if ( isset( self::DEPRECATED_TYPE_MAP[$typeName] ) ) {
            $typeName = self::DEPRECATED_TYPE_MAP[$typeName];
        }
        return isset( self::ALLOWED_TYPES[$typeName] ) ? $typeName : null;
    }
 
    public static function createList( $typeName, IContextSource $context, Title $title, array $ids ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            throw new MWException( __METHOD__ . ": Unknown RevDel type '$typeName'" );
        }
        $class = self::ALLOWED_TYPES[$typeName];
        return new $class( $context, $title, $ids );
    }
 
    protected static function checkItem( $desc, $field, $diff, $new, &$arr ) {
        if ( $diff & $field ) {
            $arr[( $new & $field ) ? 0 : 1][] = $desc;
        }
    }
 
    public static function getChanges( $n, $o ) {
        $diff = $n ^ $o;
        $ret = [ 0 => [], 1 => [], 2 => [] ];
        // Build bitfield changes in language
        self::checkItem( 'revdelete-content',
            RevisionRecord::DELETED_TEXT, $diff, $n, $ret );
        self::checkItem( 'revdelete-summary',
            RevisionRecord::DELETED_COMMENT, $diff, $n, $ret );
        self::checkItem( 'revdelete-uname',
            RevisionRecord::DELETED_USER, $diff, $n, $ret );
        // Restriction application to sysops
        if ( $diff & RevisionRecord::DELETED_RESTRICTED ) {
            if ( $n & RevisionRecord::DELETED_RESTRICTED ) {
                $ret[2][] = 'revdelete-restricted';
            } else {
                $ret[2][] = 'revdelete-unrestricted';
            }
        }
        return $ret;
    }
 
    public static function getRelationType( $typeName ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            return null;
        }
        return call_user_func( [ self::ALLOWED_TYPES[$typeName], 'getRelationType' ] );
    }
 
    public static function getRestriction( $typeName ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            return null;
        }
        return call_user_func( [ self::ALLOWED_TYPES[$typeName], 'getRestriction' ] );
    }
 
    public static function getRevdelConstant( $typeName ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            return null;
        }
        return call_user_func( [ self::ALLOWED_TYPES[$typeName], 'getRevdelConstant' ] );
    }
 
    public static function suggestTarget( $typeName, $target, array $ids ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            return $target;
        }
        return call_user_func( [ self::ALLOWED_TYPES[$typeName], 'suggestTarget' ], $target, $ids );
    }
 
    public static function checkRevisionExistence( $title, $revid ) {
        $dbr = wfGetDB( DB_REPLICA );
        $exists = $dbr->selectField( 'revision', '1',
                [ 'rev_id' => $revid ], __METHOD__ );
 
        if ( $exists ) {
            return true;
        }
 
        $timestamp = $dbr->selectField( 'archive', 'ar_timestamp',
                [ 'ar_namespace' => $title->getNamespace(),
                    'ar_title' => $title->getDBkey(),
                    'ar_rev_id' => $revid ], __METHOD__ );
 
        return $timestamp;
    }
 
    public static function extractBitfield( array $bitPars, $oldfield ) {
        // Build the actual new rev_deleted bitfield
        $newBits = 0;
        foreach ( $bitPars as $const => $val ) {
            if ( $val == 1 ) {
                $newBits |= $const; // $const is the *_deleted const
            } elseif ( $val == -1 ) {
                $newBits |= ( $oldfield & $const ); // use existing
            }
        }
        return $newBits;
    }
}