MWCallableUpdate.php

Go to the documentation of this file.

<?php
 
use Wikimedia\Rdbms\IDatabase;
 
class MWCallableUpdate
    implements DeferrableUpdate, DeferrableCallback, TransactionRoundAwareUpdate
{
    private $callback;
    private $fname;
    private $trxRoundRequirement = self::TRX_ROUND_PRESENT;
 
    public function __construct( callable $callback, $fname = 'unknown', $dbws = [] ) {
        $this->callback = $callback;
        $this->fname = $fname;
 
        $dbws = is_array( $dbws ) ? $dbws : [ $dbws ];
        foreach ( $dbws as $dbw ) {
            if ( $dbw && $dbw->trxLevel() ) {
                $dbw->onTransactionResolution( [ $this, 'cancelOnRollback' ], $fname );
            }
        }
    }
 
    public function doUpdate() {
        if ( $this->callback ) {
            call_user_func( $this->callback );
        }
    }
 
    public function cancelOnRollback( $trigger ) {
        if ( $trigger === IDatabase::TRIGGER_ROLLBACK ) {
            $this->callback = null;
        }
    }
 
    public function getOrigin() {
        return $this->fname;
    }
 
    public function setTransactionRoundRequirement( $mode ) {
        $this->trxRoundRequirement = $mode;
    }
 
    public function getTransactionRoundRequirement() {
        return $this->trxRoundRequirement;
    }
}