File: FauxGlobalHookArray.php

package info (click to toggle)
mediawiki 1%3A1.43.3%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 417,464 kB
  • sloc: php: 1,062,949; javascript: 664,290; sql: 9,714; python: 5,458; xml: 3,489; sh: 1,131; makefile: 64
file content (94 lines) | stat: -rw-r--r-- 2,101 bytes parent folder | download
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
<?php

namespace MediaWiki\HookContainer;

use InvalidArgumentException;

/**
 * @internal
 */
class FauxGlobalHookArray implements \ArrayAccess {

	private HookContainer $hookContainer;

	/**
	 * The original handler array.
	 * @var array
	 */
	private array $originalArray;

	/**
	 * @param HookContainer $hookContainer
	 * @param array $originalArray
	 */
	public function __construct( HookContainer $hookContainer, array $originalArray = [] ) {
		$this->hookContainer = $hookContainer;
		$this->originalArray = $originalArray;
	}

	/**
	 * @inheritDoc
	 */
	#[\ReturnTypeWillChange]
	public function offsetExists( $key ) {
		wfDeprecatedMsg(
			'Accessing $wgHooks directly is deprecated, use HookContainer::isRegistered() instead.',
			'1.40'
		);
		return $this->hookContainer->isRegistered( $key );
	}

	/**
	 * @inheritDoc
	 */
	#[\ReturnTypeWillChange]
	public function offsetGet( $key ) {
		wfDeprecatedMsg(
			'Accessing $wgHooks directly is deprecated, use HookContainer::getHandlers() ' .
				'or HookContainer::register() instead.',
			'1.40'
		);

		return new FauxHookHandlerArray( $this->hookContainer, $key );
	}

	/**
	 * @inheritDoc
	 */
	#[\ReturnTypeWillChange]
	public function offsetSet( $key, $value ) {
		if ( !is_string( $key ) ) {
			throw new InvalidArgumentException( '$key must be a string' );
		}
		if ( !is_array( $value ) ) {
			throw new InvalidArgumentException( '$value must be an array' );
		}

		wfDeprecatedMsg(
			'Manipulating $wgHooks is deprecated, use HookContainer::clear() and ' .
				'HookContainer::register() instead.',
			'1.40'
		);

		$this->hookContainer->clear( $key );

		foreach ( $value as $handler ) {
			$this->hookContainer->register( $key, $handler );
		}
	}

	/**
	 * @inheritDoc
	 */
	#[\ReturnTypeWillChange]
	public function offsetUnset( $key ) {
		wfDeprecatedMsg( 'Manipulating $wgHooks is deprecated, use HookContainer::clear() instead.', '1.40' );
		if ( $this->hookContainer->isRegistered( $key ) ) {
			$this->hookContainer->clear( $key );
		}
	}

	public function getOriginalArray(): array {
		return $this->originalArray;
	}
}