1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
<?php
namespace MediaWiki\Debug;
use ArrayAccess;
/**
* ArrayAccess implementation that supports deprecating access to certain properties.
* It behaves mostly as a normal array, however in order to avoid instantiating
* deprecated properties by default, a callable initializer can be set to the property.
* It will be executed upon 'get'.
* @note setting properties does not emit deprecation warnings.
* @newable
* @since 1.35
*/
class DeprecatablePropertyArray implements ArrayAccess {
/** @var array */
private $container;
/** @var array Map of deprecated property names to deprecation versions */
private $deprecatedProperties;
/** @var string */
private $name;
/** @var string|null */
private $component;
/**
* @param array $initializer Initial value of the array.
* @param array $deprecatedProperties Map of deprecated property names to versions.
* @param string $name Descriptive identifier for the array
* @param string|null $component Component to which array belongs.
* If not provided, assumed to be MW Core
*/
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] = call_user_func( $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] );
}
/**
* @param string|int $offset
* @param string $fname
* @return bool
*/
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;
}
}
|
