RevisionDeleter.php

Go to the documentation of this file.

<?php
class RevisionDeleter {
    private static $allowedTypes = array(
        'revision' => 'RevDel_RevisionList',
        'archive' => 'RevDel_ArchiveList',
        'oldimage' => 'RevDel_FileList',
        'filearchive' => 'RevDel_ArchivedFileList',
        'logging' => 'RevDel_LogList',
    );

    private static $deprecatedTypeMap = array(
        'oldid' => 'revision',
        'artimestamp' => 'archive',
        'oldimage' => 'oldimage',
        'fileid' => 'filearchive',
        'logid' => 'logging',
    );

    public static function getTypes() {
        return array_keys( self::$allowedTypes );
    }

    public static function getCanonicalTypeName( $typeName ) {
        if ( isset( self::$deprecatedTypeMap[$typeName] ) ) {
            $typeName = self::$deprecatedTypeMap[$typeName];
        }
        return isset( self::$allowedTypes[$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'" );
        }
        return new self::$allowedTypes[$typeName]( $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 = array( 0 => array(), 1 => array(), 2 => array() );
        // Build bitfield changes in language
        self::checkItem( 'revdelete-content',
            Revision::DELETED_TEXT, $diff, $n, $ret );
        self::checkItem( 'revdelete-summary',
            Revision::DELETED_COMMENT, $diff, $n, $ret );
        self::checkItem( 'revdelete-uname',
            Revision::DELETED_USER, $diff, $n, $ret );
        // Restriction application to sysops
        if ( $diff & Revision::DELETED_RESTRICTED ) {
            if ( $n & Revision::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( array( self::$allowedTypes[$typeName], 'getRelationType' ) );
    }

    public static function getRestriction( $typeName ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            return null;
        }
        return call_user_func( array( self::$allowedTypes[$typeName], 'getRestriction' ) );
    }

    public static function getRevdelConstant( $typeName ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            return null;
        }
        return call_user_func( array( self::$allowedTypes[$typeName], 'getRevdelConstant' ) );
    }

    public static function suggestTarget( $typeName, $target, array $ids ) {
        $typeName = self::getCanonicalTypeName( $typeName );
        if ( !$typeName ) {
            return $target;
        }
        return call_user_func( array( self::$allowedTypes[$typeName], 'suggestTarget' ), $target, $ids );
    }


    public static function checkRevisionExistence( $title, $revid ) {
        $dbr = wfGetDB( DB_SLAVE );
        $exists = $dbr->selectField( 'revision', '1',
                array( 'rev_id' => $revid ), __METHOD__ );

        if ( $exists ) {
            return true;
        }

        $timestamp = $dbr->selectField( 'archive', 'ar_timestamp',
                array( 'ar_namespace' => $title->getNamespace(),
                    'ar_title' => $title->getDBkey(),
                    'ar_rev_id' => $revid ), __METHOD__ );

        return $timestamp;
    }

    public static function extractBitfield( $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;
    }
}