Inheritance diagram for MediaWiki\HookContainer\HookContainer:

Collaboration diagram for MediaWiki\HookContainer\HookContainer:

Public Member Functions
	__construct (HookRegistry $hookRegistry, ObjectFactory $objectFactory)

	clear (string $hook)
	Clear hooks registered via Hooks::register(). More...

	emitDeprecationWarnings ()
	Will log a deprecation warning if: More...

	getHandlers (string $hook, array $options=[])
	Return array of handler objects registered with given hook in the new system. More...

	getHookNames ()
	Returns the names of all hooks that have at least one handler registered. More...

	getLegacyHandlers (string $hook)
	Get all handlers for legacy hooks system, plus any handlers added using register(). More...

	getRegisteredHooks ()
	Returns the names of all hooks that have handlers registered. More...

	isRegistered (string $hook)
	Return whether hook has any handlers registered to it. More...

	register (string $hook, $callback)
	Attach an event handler to a given hook. More...

	run (string $hook, array $args=[], array $options=[])
	Call registered hook functions through either the legacy $wgHooks or extension.json. More...

	salvage (SalvageableService $other)
	Salvage the state of HookContainer by retaining existing handler objects and hooks registered via HookContainer::register(). More...

	scopedRegister (string $hook, $callback, bool $replace=false)
	Register hook and handler, allowing for easy removal. More...

Detailed Description

HookContainer class.

Main class for managing hooks

Since: 1.35

Definition at line 45 of file HookContainer.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\HookContainer\HookContainer::__construct	(	HookRegistry	$hookRegistry,
		ObjectFactory	$objectFactory
	)

Parameters

HookRegistry	$hookRegistry
ObjectFactory	$objectFactory

Definition at line 75 of file HookContainer.php.

Member Function Documentation

◆ clear()

MediaWiki\HookContainer\HookContainer::clear ( string $hook )

Clear hooks registered via Hooks::register().

This is intended for use while testing and will fail if MW_PHPUNIT_TEST and MW_PARSER_TEST are not defined.

Parameters

string $hook Name of hook to clear

Access: internal: For use by Hooks.php

Exceptions

MWException If not in testing mode.

Definition at line 187 of file HookContainer.php.

◆ emitDeprecationWarnings()

MediaWiki\HookContainer\HookContainer::emitDeprecationWarnings ( )

Will log a deprecation warning if:

the hook is marked deprecated
the "silent" flag is absent or false, and
an extension registers a handler in the new way but does not acknowledge deprecation

Definition at line 518 of file HookContainer.php.

References MWDebug\sendRawDeprecated().

◆ getHandlers()

MediaWiki\HookContainer\HookContainer::getHandlers	(	string	$hook,
		array	$options = `[]`
	)

Return array of handler objects registered with given hook in the new system.

This does not include handlers registered dynamically using register(), nor does it include hooks registered via the old mechanism using $wgHooks.

Access: internal: For use by Hooks.php

Parameters

string	$hook	Name of the hook
array	$options	Handler options, which may include: noServices: Do not allow hook handlers with service dependencies

Returns: array non-deprecated handler objects

Definition at line 472 of file HookContainer.php.

◆ getHookNames()

MediaWiki\HookContainer\HookContainer::getHookNames ( )

Returns the names of all hooks that have at least one handler registered.

Returns: array

Definition at line 434 of file HookContainer.php.

◆ getLegacyHandlers()

MediaWiki\HookContainer\HookContainer::getLegacyHandlers ( string $hook )

Get all handlers for legacy hooks system, plus any handlers added using register().

Access: internal: For use by Hooks.php

Parameters

string $hook Name of hook

Returns: callable[]

Definition at line 396 of file HookContainer.php.

References $keys.

◆ getRegisteredHooks()

MediaWiki\HookContainer\HookContainer::getRegisteredHooks ( )

Returns the names of all hooks that have handlers registered.

Note that this may include hook handlers that have been disabled using clear().

Access: internal

Returns: string[]

Definition at line 451 of file HookContainer.php.

◆ isRegistered()

MediaWiki\HookContainer\HookContainer::isRegistered ( string $hook )

Return whether hook has any handlers registered to it.

The function may have been registered via Hooks::register or in extension.json

Parameters

string $hook Name of hook

Returns: bool Whether the hook has a handler registered to it

Definition at line 348 of file HookContainer.php.

◆ register()

MediaWiki\HookContainer\HookContainer::register	(	string	$hook,
			$callback
	)

Attach an event handler to a given hook.

Parameters

string	$hook	Name of hook
callable \| string \| array	$callback	handler object to attach

Definition at line 372 of file HookContainer.php.

References wfDeprecated().

◆ run()

MediaWiki\HookContainer\HookContainer::run	(	string	$hook,
		array	$args = `[]`,
		array	$options = `[]`
	)

Call registered hook functions through either the legacy $wgHooks or extension.json.

For the given hook, fetch the array of handler objects and process them. Determine the proper callback for each hook and then call the actual hook using the appropriate arguments. Finally, process the return value and return/throw accordingly.

Parameters

string	$hook	Name of the hook
array	$args	Arguments to pass to hook handler
array	$options	options map: abortable: (bool) If false, handlers will not be allowed to abort the call sequence. An exception will be raised if a handler returns anything other than true or null. deprecatedVersion: (string) Version of MediaWiki this hook was deprecated in. For supporting Hooks::run() legacy $deprecatedVersion parameter. New core code should add deprecated hooks to the DeprecatedHooks::$deprecatedHooks array literal. New extension code should use the DeprecatedHooks attribute. silent: (bool) If true, do not raise a deprecation warning noServices: (bool) If true, do not allow hook handlers with service dependencies

Returns: bool True if no handler aborted the hook

Exceptions

UnexpectedValueException if handlers return an invalid value

Definition at line 125 of file HookContainer.php.

◆ salvage()

MediaWiki\HookContainer\HookContainer::salvage ( SalvageableService $other )

Salvage the state of HookContainer by retaining existing handler objects and hooks registered via HookContainer::register().

Necessary in the event that MediaWikiServices::resetGlobalInstance() is called after hooks have already been registered.

Parameters

HookContainer | SalvageableService $other The object to salvage state from. $other be of type HookContainer

Exceptions

MWException

Definition at line 93 of file HookContainer.php.

◆ scopedRegister()

MediaWiki\HookContainer\HookContainer::scopedRegister	(	string	$hook,
			$callback,
		bool	$replace = `false`
	)

Register hook and handler, allowing for easy removal.

Intended for use in temporary registration e.g. testing

Parameters

string	$hook	Name of hook
callable \| string \| array	$callback	Handler object to attach
bool	$replace	(optional) By default adds callback to handler array. Set true to remove all existing callbacks for the hook.

Returns: ScopedCallback

Definition at line 212 of file HookContainer.php.

The documentation for this class was generated from the following file:

includes/HookContainer/HookContainer.php

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ clear()

◆ emitDeprecationWarnings()

◆ getHandlers()

◆ getHookNames()

◆ getLegacyHandlers()

◆ getRegisteredHooks()

◆ isRegistered()

◆ register()

◆ run()

◆ salvage()

◆ scopedRegister()