DeprecatablePropertyArray.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\Debug;
 
use ArrayAccess;
 
class DeprecatablePropertyArray implements ArrayAccess {
 
    private $container;
 
    private $deprecatedProperties;
 
    private $name;
 
    private $component;
 
    public function __construct(
        array $initializer,
        array $deprecatedProperties,
        string $name,
        ?string $component = null
    ) {
        $this->container = $initializer;
        $this->deprecatedProperties = $deprecatedProperties;
        $this->name = $name;
        $this->component = $component;
    }
 
    public function offsetExists( $offset ): bool {
        $this->checkDeprecatedAccess( $offset, 'exists' );
        return isset( $this->container[$offset] );
    }
 
    #[\ReturnTypeWillChange]
    public function offsetGet( $offset ) {
        if ( $this->checkDeprecatedAccess( $offset, 'get' ) ) {
            if ( is_callable( $this->container[$offset] ) ) {
                $this->container[$offset] = $this->container[$offset]();
            }
        }
        return $this->container[$offset] ?? null;
    }
 
    public function offsetSet( $offset, $value ): void {
        if ( $offset === null ) {
            $this->container[] = $value;
        } else {
            $this->container[$offset] = $value;
        }
    }
 
    public function offsetUnset( $offset ): void {
        $this->checkDeprecatedAccess( $offset, 'unset' );
        unset( $this->container[$offset] );
    }
 
    private function checkDeprecatedAccess( $offset, string $fname ): bool {
        if ( array_key_exists( $offset, $this->deprecatedProperties ) ) {
            $deprecatedVersion = $this->deprecatedProperties[$offset];
            wfDeprecated(
                "{$this->name} {$fname} '{$offset}'",
                $deprecatedVersion,
                $this->component ?? false,
                3
            );
            return true;
        }
        return false;
    }
}