MediaWiki\Config\ServiceOptions Class Reference

A class for passing options to services. More...

Public Member Functions
	__construct (array $keys,... $sources)
	assertRequiredOptions (array $expectedKeys)
	Assert that the list of options provided in this instance exactly match $expectedKeys, without regard for order.
	get ( $key)

Private Attributes
	$keys
	$options = []

Detailed Description

A class for passing options to services.

It can be constructed from a Config, and in practice most options will be taken from site configuration, but they don't have to be. The options passed are copied and will not reflect subsequent updates to site configuration (assuming they're not objects).

Services that take this type as a parameter to their constructor should specify a list of the keys they expect to receive in an array. The convention is to make it a public const called CONSTRUCTOR_OPTIONS. In the constructor, they should call assertRequiredOptions() to make sure that they weren't passed too few or too many options. This way it's clear what each class depends on, and that it's getting passed the correct set of options. (This means there are no optional options. This makes sense for services, since they shouldn't be constructed by outside code.)

@newable since 1.36

Since

1.34

Definition at line 27 of file ServiceOptions.php.

Constructor & Destructor Documentation

__construct()

MediaWiki\Config\ServiceOptions::__construct	(	array	$keys,
			$sources
	)

Stability: stable

to call since 1.36

Parameters

string[]	$keys	Which keys to extract from $sources
	Config|ServiceOptions|array	...$sources Each source is either a Config object or an array. If the same key is present in two sources, the first one takes precedence. Keys that are not in $keys are ignored.

Exceptions

InvalidArgumentException

if one of $keys is not found in any of $sources

Definition at line 40 of file ServiceOptions.php.

References MediaWiki\Config\ServiceOptions\$keys, and $source.

Member Function Documentation

assertRequiredOptions()

MediaWiki\Config\ServiceOptions::assertRequiredOptions

(

array

$expectedKeys

)

Assert that the list of options provided in this instance exactly match $expectedKeys, without regard for order.

Parameters

string[]

$expectedKeys

Definition at line 71 of file ServiceOptions.php.

Referenced by MediaWiki\Storage\EditResultCache\__construct(), MediaWiki\Parser\ParserCacheFactory\__construct(), MediaWiki\Page\DeletePage\__construct(), MediaWiki\Storage\BlobStoreFactory\__construct(), MediaWiki\Storage\EditResultBuilder\__construct(), MediaWiki\Storage\RevertedTagUpdate\__construct(), MediaWiki\Storage\PageUpdaterFactory\__construct(), PasswordReset\__construct(), MediaWiki\Permissions\GroupPermissionsLookup\__construct(), MediaWiki\Block\BlockUser\__construct(), MediaWiki\Block\BlockPermissionCheckerFactory\__construct(), MediaWiki\Block\BlockPermissionChecker\__construct(), MediaWiki\User\BotPasswordStore\__construct(), MediaWiki\User\UserGroupManager\__construct(), MediaWiki\JobQueue\JobQueueGroupFactory\__construct(), MediaWiki\User\UserOptionsManager\__construct(), MediaWiki\Languages\LanguageNameUtils\__construct(), NamespaceInfo\__construct(), MediaWiki\Block\UserBlockCommandFactory\__construct(), MediaWiki\Watchlist\WatchlistManager\__construct(), MediaWiki\Page\PageStoreFactory\__construct(), WatchedItemStore\__construct(), MediaWiki\User\ActorStoreFactory\__construct(), MediaWiki\Page\PageStore\__construct(), MediaWiki\Page\RollbackPage\__construct(), MediaWiki\User\DefaultOptionsLookup\__construct(), MediaWiki\User\UserNameUtils\__construct(), MediaWiki\Preferences\DefaultPreferencesFactory\__construct(), MediaWiki\SpecialPage\SpecialPageFactory\__construct(), LocalisationCache\__construct(), MediaWiki\Languages\LanguageFactory\__construct(), MediaWiki\Http\HttpRequestFactory\__construct(), MediaWiki\Block\DatabaseBlockStore\__construct(), MediaWiki\Collation\CollationFactory\__construct(), MediaWiki\User\CentralId\CentralIdLookupFactory\__construct(), MediaWiki\Block\BlockManager\__construct(), MediaWiki\Rest\CorsUtils\__construct(), MediaWiki\Permissions\PermissionManager\__construct(), MediaWiki\EditPage\Constraint\EditConstraintFactory\__construct(), MediaWiki\Block\BlockUtils\__construct(), MediaWiki\Permissions\RestrictionStore\__construct(), MediaWiki\User\TalkPageNotificationManager\__construct(), Parser\__construct(), ParserFactory\__construct(), MediaWiki\Storage\PageUpdater\__construct(), and MWLBFactory\applyDefaultConfig().

get()

MediaWiki\Config\ServiceOptions::get

(

$key

)

Parameters

string

$key

Returns

mixed

Definition at line 93 of file ServiceOptions.php.

Referenced by MediaWiki\Permissions\GroupPermissionsLookup\__construct(), FileBackendGroup\__construct(), WatchedItemStore\__construct(), MediaWiki\User\ActorStoreFactory\__construct(), LocalisationCache\__construct(), MediaWiki\User\CentralId\CentralIdLookupFactory\__construct(), MediaWiki\User\TalkPageNotificationManager\__construct(), Parser\__construct(), MediaWiki\Storage\PageUpdater\__construct(), MWLBFactory\applyDefaultConfig(), MediaWiki\Http\HttpRequestFactory\create(), MediaWiki\Http\HttpRequestFactory\createMultiClient(), CoreMagicVariables\expand(), and MWLBFactory\initServerInfo().

Member Data Documentation

$keys

MediaWiki\Config\ServiceOptions::$keys

private

Definition at line 28 of file ServiceOptions.php.

Referenced by MediaWiki\Config\ServiceOptions\__construct().

$options

MediaWiki\Config\ServiceOptions::$options = []

private

Definition at line 29 of file ServiceOptions.php.

---

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

• includes/config/ServiceOptions.php