DeprecationHelper.php

Go to the documentation of this file.

<?php
trait DeprecationHelper {
 
    protected $deprecatedPublicProperties = [];
 
    protected function deprecatePublicProperty(
        $property, $version, $class = null, $component = null
    ) {
        $this->deprecatedPublicProperties[$property] = [ $version, $class ?: __CLASS__, $component ];
    }
 
    public function __get( $name ) {
        if ( isset( $this->deprecatedPublicProperties[$name] ) ) {
            list( $version, $class, $component ) = $this->deprecatedPublicProperties[$name];
            $qualifiedName = $class . '::$' . $name;
            wfDeprecated( $qualifiedName, $version, $component, 3 );
            return $this->$name;
        }
 
        $ownerClass = $this->deprecationHelperGetPropertyOwner( $name );
        $qualifiedName = ( $ownerClass ?: get_class( $this ) ) . '::$' . $name;
        if ( $ownerClass ) {
            // Someone tried to access a normal non-public property. Try to behave like PHP would.
            trigger_error( "Cannot access non-public property $qualifiedName", E_USER_ERROR );
        } else {
            // Non-existing property. Try to behave like PHP would.
            trigger_error( "Undefined property: $qualifiedName", E_USER_NOTICE );
        }
        return null;
    }
 
    public function __set( $name, $value ) {
        if ( isset( $this->deprecatedPublicProperties[$name] ) ) {
            list( $version, $class, $component ) = $this->deprecatedPublicProperties[$name];
            $qualifiedName = $class . '::$' . $name;
            wfDeprecated( $qualifiedName, $version, $component, 3 );
            $this->$name = $value;
            return;
        }
 
        $ownerClass = $this->deprecationHelperGetPropertyOwner( $name );
        $qualifiedName = ( $ownerClass ?: get_class( $this ) ) . '::$' . $name;
        if ( $ownerClass ) {
            // Someone tried to access a normal non-public property. Try to behave like PHP would.
            trigger_error( "Cannot access non-public property $qualifiedName", E_USER_ERROR );
        } else {
            // Non-existing property. Try to behave like PHP would.
            $this->$name = $value;
        }
    }
 
    private function deprecationHelperGetPropertyOwner( $property ) {
        // Returning false is a non-error path and should avoid slow checks like reflection.
        // Use array cast hack instead.
        $obfuscatedProps = array_keys( (array)$this );
        $obfuscatedPropTail = "\0$property";
        foreach ( $obfuscatedProps as $obfuscatedProp ) {
            // private props are in the form \0<classname>\0<propname>
            if ( strpos( $obfuscatedProp, $obfuscatedPropTail, 1 ) !== false ) {
                $classname = substr( $obfuscatedProp, 1, -strlen( $obfuscatedPropTail ) );
                if ( $classname === '*' ) {
                    // protected property; we didn't get the name, but we are on an error path
                    // now so it's fine to use reflection
                    return ( new ReflectionProperty( $this, $property ) )->getDeclaringClass()->getName();
                }
                return $classname;
            }
        }
        return false;
    }
}