RevDelList.php

Go to the documentation of this file.

<?php
abstract class RevDelList extends RevisionListBase {
    function __construct( IContextSource $context, Title $title, array $ids ) {
        parent::__construct( $context, $title );
        $this->ids = $ids;
    }

    public static function getRelationType() {
        return null;
    }

    public static function getRestriction() {
        return null;
    }

    public static function getRevdelConstant() {
        return null;
    }

    public static function suggestTarget( $target, array $ids ) {
        return $target;
    }

    public function areAnySuppressed() {
        $bit = $this->getSuppressBit();

        // @codingStandardsIgnoreStart Generic.CodeAnalysis.ForLoopWithTestFunctionCall.NotAllowed
        for ( $this->reset(); $this->current(); $this->next() ) {
            // @codingStandardsIgnoreEnd
            $item = $this->current();
            if ( $item->getBits() & $bit ) {
                return true;
            }
        }
        return false;
    }

    public function setVisibility( array $params ) {
        $bitPars = $params['value'];
        $comment = $params['comment'];
        $perItemStatus = isset( $params['perItemStatus'] ) ? $params['perItemStatus'] : false;

        // CAS-style checks are done on the _deleted fields so the select
        // does not need to use FOR UPDATE nor be in the atomic section
        $dbw = wfGetDB( DB_MASTER );
        $this->res = $this->doQuery( $dbw );

        $dbw->startAtomic( __METHOD__ );

        $status = Status::newGood();
        $missing = array_flip( $this->ids );
        $this->clearFileOps();
        $idsForLog = [];
        $authorIds = $authorIPs = [];

        if ( $perItemStatus ) {
            $status->itemStatuses = [];
        }

        // @codingStandardsIgnoreStart Generic.CodeAnalysis.ForLoopWithTestFunctionCall.NotAllowed
        for ( $this->reset(); $this->current(); $this->next() ) {
            // @codingStandardsIgnoreEnd
            $item = $this->current();
            unset( $missing[$item->getId()] );

            if ( $perItemStatus ) {
                $itemStatus = Status::newGood();
                $status->itemStatuses[$item->getId()] = $itemStatus;
            } else {
                $itemStatus = $status;
            }

            $oldBits = $item->getBits();
            // Build the actual new rev_deleted bitfield
            $newBits = RevisionDeleter::extractBitfield( $bitPars, $oldBits );

            if ( $oldBits == $newBits ) {
                $itemStatus->warning( 'revdelete-no-change', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            } elseif ( $oldBits == 0 && $newBits != 0 ) {
                $opType = 'hide';
            } elseif ( $oldBits != 0 && $newBits == 0 ) {
                $opType = 'show';
            } else {
                $opType = 'modify';
            }

            if ( $item->isHideCurrentOp( $newBits ) ) {
                // Cannot hide current version text
                $itemStatus->error( 'revdelete-hide-current', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            }
            if ( !$item->canView() ) {
                // Cannot access this revision
                $msg = ( $opType == 'show' ) ?
                    'revdelete-show-no-access' : 'revdelete-modify-no-access';
                $itemStatus->error( $msg, $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            }
            // Cannot just "hide from Sysops" without hiding any fields
            if ( $newBits == Revision::DELETED_RESTRICTED ) {
                $itemStatus->warning( 'revdelete-only-restricted', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            }

            // Update the revision
            $ok = $item->setBits( $newBits );

            if ( $ok ) {
                $idsForLog[] = $item->getId();
                $status->successCount++;
                if ( $item->getAuthorId() > 0 ) {
                    $authorIds[] = $item->getAuthorId();
                } elseif ( IP::isIPAddress( $item->getAuthorName() ) ) {
                    $authorIPs[] = $item->getAuthorName();
                }
            } else {
                $itemStatus->error( 'revdelete-concurrent-change', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
            }
        }

        // Handle missing revisions
        foreach ( $missing as $id => $unused ) {
            if ( $perItemStatus ) {
                $status->itemStatuses[$id] = Status::newFatal( 'revdelete-modify-missing', $id );
            } else {
                $status->error( 'revdelete-modify-missing', $id );
            }
            $status->failCount++;
        }

        if ( $status->successCount == 0 ) {
            $dbw->rollback( __METHOD__ );
            return $status;
        }

        // Save success count
        $successCount = $status->successCount;

        // Move files, if there are any
        $status->merge( $this->doPreCommitUpdates() );
        if ( !$status->isOK() ) {
            // Fatal error, such as no configured archive directory
            $dbw->rollback( __METHOD__ );
            return $status;
        }

        // Log it
        // @FIXME: $newBits/$oldBits set in for loop, makes IDE warnings too
        $this->updateLog( [
            'title' => $this->title,
            'count' => $successCount,
            'newBits' => $newBits,
            'oldBits' => $oldBits,
            'comment' => $comment,
            'ids' => $idsForLog,
            'authorIds' => $authorIds,
            'authorIPs' => $authorIPs
        ] );

        // Clear caches
        $that = $this;
        $dbw->onTransactionIdle( function() use ( $that ) {
            $that->doPostCommitUpdates();
        } );

        $dbw->endAtomic( __METHOD__ );

        return $status;
    }

    function reloadFromMaster() {
        $dbw = wfGetDB( DB_MASTER );
        $this->res = $this->doQuery( $dbw );
    }

    protected function updateLog( $params ) {
        // Get the URL param's corresponding DB field
        $field = RevisionDeleter::getRelationType( $this->getType() );
        if ( !$field ) {
            throw new MWException( "Bad log URL param type!" );
        }
        // Put things hidden from sysops in the suppression log
        if ( ( $params['newBits'] | $params['oldBits'] ) & $this->getSuppressBit() ) {
            $logType = 'suppress';
        } else {
            $logType = 'delete';
        }
        // Add params for affected page and ids
        $logParams = $this->getLogParams( $params );
        // Actually add the deletion log entry
        $logEntry = new ManualLogEntry( $logType, $this->getLogAction() );
        $logEntry->setTarget( $params['title'] );
        $logEntry->setComment( $params['comment'] );
        $logEntry->setParameters( $logParams );
        $logEntry->setPerformer( $this->getUser() );
        // Allow for easy searching of deletion log items for revision/log items
        $logEntry->setRelations( [
            $field => $params['ids'],
            'target_author_id' => $params['authorIds'],
            'target_author_ip' => $params['authorIPs'],
        ] );
        $logId = $logEntry->insert();
        $logEntry->publish( $logId );
    }

    public function getLogAction() {
        return 'revision';
    }

    public function getLogParams( $params ) {
        return [
            '4::type' => $this->getType(),
            '5::ids' => $params['ids'],
            '6::ofield' => $params['oldBits'],
            '7::nfield' => $params['newBits'],
        ];
    }

    public function clearFileOps() {
    }

    public function doPreCommitUpdates() {
        return Status::newGood();
    }

    public function doPostCommitUpdates() {
        return Status::newGood();
    }

    abstract public function getSuppressBit();
}