StubObject.php

Go to the documentation of this file.

<?php
use Wikimedia\ObjectFactory;

class StubObject {
    protected $global;

    protected $class;

    protected $factory;

    protected $params;

    public function __construct( $global = null, $class = null, $params = [] ) {
        $this->global = $global;
        if ( is_callable( $class ) ) {
            $this->factory = $class;
        } else {
            $this->class = $class;
        }
        $this->params = $params;
    }

    public static function isRealObject( $obj ) {
        return is_object( $obj ) && !$obj instanceof StubObject;
    }

    public static function unstub( &$obj ) {
        if ( $obj instanceof StubObject ) {
            $obj = $obj->_unstub( 'unstub', 3 );
        }
    }

    public function _call( $name, $args ) {
        $this->_unstub( $name, 5 );
        return call_user_func_array( [ $GLOBALS[$this->global], $name ], $args );
    }

    public function _newObject() {
        $params = $this->factory
            ? [ 'factory' => $this->factory ]
            : [ 'class' => $this->class ];
        return ObjectFactory::getObjectFromSpec( $params + [
            'args' => $this->params,
            'closure_expansion' => false,
        ] );
    }

    public function __call( $name, $args ) {
        return $this->_call( $name, $args );
    }

    public function _unstub( $name = '_unstub', $level = 2 ) {
        static $recursionLevel = 0;

        if ( !$GLOBALS[$this->global] instanceof StubObject ) {
            return $GLOBALS[$this->global]; // already unstubbed.
        }

        if ( get_class( $GLOBALS[$this->global] ) != $this->class ) {
            $caller = wfGetCaller( $level );
            if ( ++$recursionLevel > 2 ) {
                throw new MWException( "Unstub loop detected on call of "
                    . "\${$this->global}->$name from $caller\n" );
            }
            wfDebug( "Unstubbing \${$this->global} on call of "
                . "\${$this->global}::$name from $caller\n" );
            $GLOBALS[$this->global] = $this->_newObject();
            --$recursionLevel;
            return $GLOBALS[$this->global];
        }
    }
}