MediaWikiServices is the service locator for the application scope of MediaWiki. More...

Inheritance diagram for MediaWiki\MediaWikiServices:

Collaboration diagram for MediaWiki\MediaWikiServices:

Public Member Functions
	__construct (Config $config)

	getActorMigration ()

	getBadFileLookup ()

	getBlobStore ()

	getBlobStoreFactory ()

	getBlockManager ()

	getBlockRestrictionStore ()

	getBootstrapConfig ()
	Returns the Config object containing the bootstrap configuration. More...

	getChangeTagDefStore ()

	getCommentStore ()

	getConfigFactory ()

	getConfigRepository ()

	getConfiguredReadOnlyMode ()

	getContentLanguage ()

	getContentModelStore ()

	getCryptHKDF ()

	getDateFormatterFactory ()

	getDBLoadBalancer ()

	getDBLoadBalancerFactory ()

	getEventRelayerGroup ()

	getExternalStoreAccess ()

	getExternalStoreFactory ()

	getGenderCache ()

	getHttpRequestFactory ()

	getInterwikiLookup ()

	getLinkCache ()

	getLinkRenderer ()
	LinkRenderer instance that can be used if no custom options are needed. More...

	getLinkRendererFactory ()

	getLocalServerObjectCache ()

	getLockManagerGroupFactory ()

	getMagicWordFactory ()

	getMainConfig ()
	Returns the Config object that provides configuration for MediaWiki core. More...

	getMainObjectStash ()

	getMainWANObjectCache ()

	getMediaHandlerFactory ()

	getMessageCache ()

	getMessageFormatterFactory ()

	getMimeAnalyzer ()

	getMovePageFactory ()

	getNamespaceInfo ()

	getNameTableStoreFactory ()

	getObjectFactory ()
	ObjectFactory is intended for instantiating "handlers" from declarative definitions, such as Action API modules, special pages, or REST API handlers. More...

	getOldRevisionImporter ()

	getPageEditStash ()

	getParser ()

	getParserCache ()

	getParserFactory ()

	getPasswordFactory ()

	getPerDbNameStatsdDataFactory ()

	getPermissionManager ()

	getPreferencesFactory ()

	getProxyLookup ()

	getReadOnlyMode ()

	getRepoGroup ()

	getResourceLoader ()

	getRevisionFactory ()

	getRevisionLookup ()

	getRevisionRenderer ()

	getRevisionStore ()

	getRevisionStoreFactory ()

	getSearchEngineConfig ()

	getSearchEngineFactory ()

	getShellCommandFactory ()

	getSiteLookup ()

	getSiteStore ()

	getSkinFactory ()

	getSlotRoleRegistry ()

	getSlotRoleStore ()

	getSpecialPageFactory ()

	getStatsdDataFactory ()

	getTempFSFileFactory ()

	getTitleFormatter ()

	getTitleParser ()

	getUploadRevisionImporter ()

	getVirtualRESTServiceClient ()

	getWatchedItemQueryService ()

	getWatchedItemStore ()

	getWikiRevisionOldRevisionImporter ()

	getWikiRevisionOldRevisionImporterNoUpdates ()

	getWikiRevisionUploadImporter ()

	newSearchEngine ()

	resetServiceForTesting ( $name, $destroy=true)
	Resets the given service for testing purposes. More...

Public Member Functions inherited from Wikimedia\Services\ServiceContainer
	__construct (array $extraInstantiationParams=[])

	addServiceManipulator ( $name, callable $manipulator)
	Add a service manipulator callback for the given service. More...

	applyWiring (array $serviceInstantiators)
	Registers multiple services (aka a "wiring"). More...

	defineService ( $name, callable $instantiator)
	Define a new service. More...

	destroy ()
	Destroys all contained service instances that implement the DestructibleService interface. More...

	disableService ( $name)
	Disables a service. More...

	get ( $name)

	getService ( $name)
	Returns a service object of the kind associated with $name. More...

	getServiceNames ()

	has ( $name)

	hasService ( $name)
	Returns true if a service is defined for $name, that is, if a call to getService( $name ) would return a service instance. More...

	importWiring (ServiceContainer $container, $skip=[])
	Imports all wiring defined in $container. More...

	isServiceDisabled ( $name)

	loadWiringFiles (array $wiringFiles)

	peekService ( $name)
	Returns the service instance for $name only if that service has already been instantiated. More...

	redefineService ( $name, callable $instantiator)
	Replace an already defined service. More...

Static Public Member Functions
static	disableStorageBackend ()
	Disables all storage layer services. More...

static	failIfResetNotAllowed ( $method)
	Convenience method that throws an exception unless it is called during a phase in which resetting of global services is allowed. More...

static	forceGlobalInstance (MediaWikiServices $services)
	Replaces the global MediaWikiServices instance. More...

static	getInstance ()
	Returns the global default instance of the top level service locator. More...

static	resetChildProcessServices ()
	Resets any services that may have become stale after a child process returns from after pcntl_fork(). More...

static	resetGlobalInstance (Config $bootstrapConfig=null, $quick='')
	Creates a new instance of MediaWikiServices and sets it as the global default instance. More...

Private Member Functions
	salvage (self $other)
	PhpDocSignatureInspection More...

Static Private Member Functions
static	newInstance (Config $bootstrapConfig, $loadWiring='')
	Creates a new MediaWikiServices instance and initializes it according to the given $bootstrapConfig. More...

Static Private Attributes
static MediaWikiServices null	$instance = null

Additional Inherited Members
Protected Member Functions inherited from Wikimedia\Services\ServiceContainer
	resetService ( $name, $destroy=true)
	Resets a service by dropping the service instance. More...

Detailed Description

MediaWikiServices is the service locator for the application scope of MediaWiki.

Its implemented as a simple configurable DI container. MediaWikiServices acts as a top level factory/registry for top level services, and builds the network of service objects that defines MediaWiki's application logic. It acts as an entry point to MediaWiki's dependency injection mechanism.

Services are defined in the "wiring" array passed to the constructor, or by calling defineService().

See also: docs/injection.txt for an overview of using dependency injection in the MediaWiki code base.

Definition at line 114 of file MediaWikiServices.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\MediaWikiServices::__construct ( Config $config )

Parameters

Config $config The Config object to be registered as the 'BootstrapConfig' service. This has to contain at least the information needed to set up the 'ConfigFactory' service.

Definition at line 416 of file MediaWikiServices.php.

Member Function Documentation

◆ disableStorageBackend()

static MediaWiki\MediaWikiServices::disableStorageBackend ( )

static

Disables all storage layer services.

After calling this, any attempt to access the storage layer will result in an error. Use resetGlobalInstance() to restore normal operation.

Since: 1.28

Warning: This is intended for extreme situations only and should never be used while serving normal web requests. Legitimate use cases for this method include the installation process. Test fixtures may also use this, if the fixture relies on globalState.

See also: resetGlobalInstance(); resetChildProcessServices()

Definition at line 310 of file MediaWikiServices.php.

References ObjectCache\clear().

◆ failIfResetNotAllowed()

static MediaWiki\MediaWikiServices::failIfResetNotAllowed ( $method )

static

Convenience method that throws an exception unless it is called during a phase in which resetting of global services is allowed.

In general, services should not be reset individually, since that may introduce inconsistencies.

Since: 1.28

This method will throw an exception if:

self::$resetInProgress is false (to allow all services to be reset together via resetGlobalInstance)
and MEDIAWIKI_INSTALL is not defined (to allow services to be reset during installation)
and MW_PHPUNIT_TEST is not defined (to allow services to be reset during testing)

This method is intended to be used to safeguard against accidentally resetting global service instances that are not yet managed by MediaWikiServices. It is defined here in the MediaWikiServices services class to have a central place for managing service bootstrapping and resetting.

Parameters

string $method the name of the caller method, as given by METHOD.

Exceptions

MWException if called outside bootstrap mode.

See also: resetGlobalInstance(); forceGlobalInstance(); disableStorageBackend()

Definition at line 400 of file MediaWikiServices.php.

◆ forceGlobalInstance()

static MediaWiki\MediaWikiServices::forceGlobalInstance ( MediaWikiServices $services )

static

Replaces the global MediaWikiServices instance.

Since: 1.28

Note: This is for use in PHPUnit tests only!

Exceptions

MWException if called outside of PHPUnit tests.

Parameters

MediaWikiServices $services The new MediaWikiServices object.

Returns: MediaWikiServices The old MediaWikiServices object, so it can be restored later.

Definition at line 161 of file MediaWikiServices.php.

◆ getActorMigration()

MediaWiki\MediaWikiServices::getActorMigration ( )

Since: 1.31

Returns: ActorMigration

Definition at line 431 of file MediaWikiServices.php.

◆ getBadFileLookup()

MediaWiki\MediaWikiServices::getBadFileLookup ( )

Since: 1.34

Returns: BadFileLookup

Definition at line 439 of file MediaWikiServices.php.

◆ getBlobStore()

MediaWiki\MediaWikiServices::getBlobStore ( )

Since: 1.31

Returns: BlobStore

Definition at line 447 of file MediaWikiServices.php.

◆ getBlobStoreFactory()

MediaWiki\MediaWikiServices::getBlobStoreFactory ( )

Since: 1.31

Returns: BlobStoreFactory

Definition at line 455 of file MediaWikiServices.php.

◆ getBlockManager()

MediaWiki\MediaWikiServices::getBlockManager ( )

Since: 1.34

Returns: BlockManager

Definition at line 463 of file MediaWikiServices.php.

◆ getBlockRestrictionStore()

MediaWiki\MediaWikiServices::getBlockRestrictionStore ( )

Since: 1.33

Returns: BlockRestrictionStore

Definition at line 471 of file MediaWikiServices.php.

◆ getBootstrapConfig()

MediaWiki\MediaWikiServices::getBootstrapConfig ( )

Returns the Config object containing the bootstrap configuration.

Bootstrap configuration would typically include database credentials and other information that may be needed before the ConfigFactory service can be instantiated.

Note: This should only be used during bootstrapping, in particular when creating the MainConfig service. Application logic should use getMainConfig() to get a Config instances.

Since: 1.27

Returns: Config

Definition at line 488 of file MediaWikiServices.php.

◆ getChangeTagDefStore()

MediaWiki\MediaWikiServices::getChangeTagDefStore ( )

Since: 1.32

Returns: NameTableStore

Definition at line 496 of file MediaWikiServices.php.

◆ getCommentStore()

MediaWiki\MediaWikiServices::getCommentStore ( )

Since: 1.31

Returns: CommentStore

Definition at line 504 of file MediaWikiServices.php.

◆ getConfigFactory()

MediaWiki\MediaWikiServices::getConfigFactory ( )

Since: 1.27

Returns: ConfigFactory

Definition at line 512 of file MediaWikiServices.php.

◆ getConfigRepository()

MediaWiki\MediaWikiServices::getConfigRepository ( )

Since: 1.32

Returns: ConfigRepository

Definition at line 520 of file MediaWikiServices.php.

◆ getConfiguredReadOnlyMode()

MediaWiki\MediaWikiServices::getConfiguredReadOnlyMode ( )

Since: 1.29

Returns: \ConfiguredReadOnlyMode

Definition at line 528 of file MediaWikiServices.php.

◆ getContentLanguage()

MediaWiki\MediaWikiServices::getContentLanguage ( )

Since: 1.32

Returns: \Language

Definition at line 536 of file MediaWikiServices.php.

◆ getContentModelStore()

MediaWiki\MediaWikiServices::getContentModelStore ( )

Since: 1.31

Returns: NameTableStore

Definition at line 544 of file MediaWikiServices.php.

◆ getCryptHKDF()

MediaWiki\MediaWikiServices::getCryptHKDF ( )

Since: 1.28

Returns: CryptHKDF

Definition at line 552 of file MediaWikiServices.php.

◆ getDateFormatterFactory()

MediaWiki\MediaWikiServices::getDateFormatterFactory ( )

Since: 1.33

Returns: DateFormatterFactory

Definition at line 560 of file MediaWikiServices.php.

◆ getDBLoadBalancer()

MediaWiki\MediaWikiServices::getDBLoadBalancer ( )

Since: 1.28

Returns: ILoadBalancer The main DB load balancer for the local wiki.

Definition at line 568 of file MediaWikiServices.php.

◆ getDBLoadBalancerFactory()

MediaWiki\MediaWikiServices::getDBLoadBalancerFactory ( )

Since: 1.28

Returns: LBFactory

Definition at line 576 of file MediaWikiServices.php.

◆ getEventRelayerGroup()

MediaWiki\MediaWikiServices::getEventRelayerGroup ( )

Since: 1.27

Returns: EventRelayerGroup

Definition at line 584 of file MediaWikiServices.php.

◆ getExternalStoreAccess()

MediaWiki\MediaWikiServices::getExternalStoreAccess ( )

Since: 1.34

Returns: \ExternalStoreAccess

Definition at line 592 of file MediaWikiServices.php.

◆ getExternalStoreFactory()

MediaWiki\MediaWikiServices::getExternalStoreFactory ( )

Since: 1.31

Returns: \ExternalStoreFactory

Definition at line 600 of file MediaWikiServices.php.

◆ getGenderCache()

MediaWiki\MediaWikiServices::getGenderCache ( )

Since: 1.28

Returns: GenderCache

Definition at line 608 of file MediaWikiServices.php.

◆ getHttpRequestFactory()

MediaWiki\MediaWikiServices::getHttpRequestFactory ( )

Since: 1.31

Returns: HttpRequestFactory

Definition at line 616 of file MediaWikiServices.php.

◆ getInstance()

static MediaWiki\MediaWikiServices::getInstance ( )

static

Returns the global default instance of the top level service locator.

Since: 1.27

The default instance is initialized using the service instantiator functions defined in ServiceWiring.php.

Note: This should only be called by static functions! The instance returned here should not be passed around! Objects that need access to a service should have that service injected into the constructor, never a service locator!

Returns: MediaWikiServices

Definition at line 135 of file MediaWikiServices.php.

Referenced by MediaWiki\Auth\Throttler\__construct(), MediaWiki\Session\SessionManager\__construct(), MediaWiki\Block\AbstractBlock\appliesToRight(), MediaWiki\Auth\AuthManager\autoCreateUser(), MediaWiki\Auth\AuthManager\checkAccountCreatePermissions(), File\checkExtensionCompatibility(), MediaWiki\Preferences\DefaultPreferencesFactory\cleanSignature(), MediaWiki\Block\DatabaseBlock\clearCookie(), MediaWiki\Shell\Shell\command(), StreamFile\contentTypeFromPath(), DeleteAutoPatrolLogs\deleteRows(), PopulateChangeTagDef\doDBUpdates(), MediaWiki\Storage\DerivedPageDataUpdater\doUpdates(), SpecialNewFiles\execute(), RunBatchedQuery\execute(), ImageBuilder\execute(), RebuildFileCache\finalSetup(), MediaWiki\Widget\Search\FullSearchResultWidget\generateFileHtml(), ApiQuerySearch\getAllowedParams(), MediaWiki\Block\DatabaseBlock\getBlockRestrictionStore(), MediaWiki\Block\DatabaseBlock\getBlocksForIPList(), MediaWiki\Block\DatabaseBlock\getCookieValue(), UploadStash\getExtensionForPath(), SpecialMediaStatistics\getExtensionList(), MediaWiki\Auth\UserDataAuthenticationRequest\getFieldInfo(), MediaWiki\Block\DatabaseBlock\getIdFromCookieValue(), ForeignAPIFile\getMediaType(), UnregisteredLocalFile\getMimeType(), ForeignAPIFile\getMimeType(), DeleteAutoPatrolLogs\getRows(), DeleteAutoPatrolLogs\getRowsOld(), MediaWiki\EditPage\TextboxBuilder\getTextboxProtectionCSSClasses(), MediaHandler\getThumbType(), DjVuHandler\getThumbType(), UploadBase\getTitle(), FileBackendGroup\guessMimeInternal(), ChannelFeed\httpHeaders(), MediaWiki\Block\DatabaseBlock\isWhitelistedFromAutoblocks(), MediaWiki\Rest\EntryPoint\main(), MediaWiki\Auth\TemporaryPasswordAuthenticationRequest\newRandom(), MediaWiki\parseTitle(), MediaWiki\performRequest(), MediaWiki\Widget\Search\SearchFormWidget\powerSearchBox(), MediaWiki\preOutputCommit(), MediaWiki\Storage\DerivedPageDataUpdater\prepareContent(), MediaWiki\Block\AbstractBlock\prevents(), MediaWiki\Preferences\DefaultPreferencesFactory\profilePreferences(), MediaWiki\Block\DatabaseBlock\purgeExpired(), MediaWiki\Widget\Search\FullSearchResultWidget\render(), MediaWiki\Widget\Search\BasicSearchResultSetWidget\render(), MediaWiki\restInPeace(), MediaWiki\Linker\LinkRenderer\runLegacyBeginHook(), MediaWiki\Block\DatabaseBlock\setCookie(), MediaWiki\setDBProfilingAgent(), MediaWiki\Auth\AuthManager\setDefaultUserOptions(), MediaWiki\Auth\AuthManager\singleton(), MediaWiki\Widget\Search\SearchFormWidget\startsWithImage(), MediaWiki\triggerAsyncJobs(), MediaWiki\tryNormaliseRedirect(), Revision\RevisionRecord\userCanBitfield(), MediaWiki\Preferences\DefaultPreferencesFactory\validateSignature(), UploadBase\verifyExtension(), and UploadBase\verifyMimeType().

◆ getInterwikiLookup()

MediaWiki\MediaWikiServices::getInterwikiLookup ( )

Since: 1.28

Returns: InterwikiLookup

Definition at line 624 of file MediaWikiServices.php.

◆ getLinkCache()

MediaWiki\MediaWikiServices::getLinkCache ( )

Since: 1.28

Returns: LinkCache

Definition at line 632 of file MediaWikiServices.php.

◆ getLinkRenderer()

MediaWiki\MediaWikiServices::getLinkRenderer ( )

LinkRenderer instance that can be used if no custom options are needed.

Since: 1.28

Returns: LinkRenderer

Definition at line 643 of file MediaWikiServices.php.

◆ getLinkRendererFactory()

MediaWiki\MediaWikiServices::getLinkRendererFactory ( )

Since: 1.28

Returns: LinkRendererFactory

Definition at line 651 of file MediaWikiServices.php.

◆ getLocalServerObjectCache()

MediaWiki\MediaWikiServices::getLocalServerObjectCache ( )

Since: 1.28

Returns: \BagOStuff

Definition at line 659 of file MediaWikiServices.php.

◆ getLockManagerGroupFactory()

MediaWiki\MediaWikiServices::getLockManagerGroupFactory ( )

Since: 1.34

Returns: LockManagerGroupFactory

Definition at line 667 of file MediaWikiServices.php.

◆ getMagicWordFactory()

MediaWiki\MediaWikiServices::getMagicWordFactory ( )

Since: 1.32

Returns: MagicWordFactory

Definition at line 675 of file MediaWikiServices.php.

◆ getMainConfig()

MediaWiki\MediaWikiServices::getMainConfig ( )

Returns the Config object that provides configuration for MediaWiki core.

This may or may not be the same object that is returned by getBootstrapConfig().

Since: 1.27

Returns: Config

Definition at line 686 of file MediaWikiServices.php.

Referenced by MediaWiki\Rest\EntryPoint\getTextFormatters().

◆ getMainObjectStash()

MediaWiki\MediaWikiServices::getMainObjectStash ( )

Since: 1.28

Returns: \BagOStuff

Definition at line 694 of file MediaWikiServices.php.

◆ getMainWANObjectCache()

MediaWiki\MediaWikiServices::getMainWANObjectCache ( )

Since: 1.28

Returns: \WANObjectCache

Definition at line 702 of file MediaWikiServices.php.

◆ getMediaHandlerFactory()

MediaWiki\MediaWikiServices::getMediaHandlerFactory ( )

Since: 1.28

Returns: MediaHandlerFactory

Definition at line 710 of file MediaWikiServices.php.

◆ getMessageCache()

MediaWiki\MediaWikiServices::getMessageCache ( )

Since: 1.34

Returns: MessageCache

Definition at line 718 of file MediaWikiServices.php.

◆ getMessageFormatterFactory()

MediaWiki\MediaWikiServices::getMessageFormatterFactory ( )

Since: 1.34

Returns: IMessageFormatterFactory

Definition at line 726 of file MediaWikiServices.php.

Referenced by MediaWiki\Rest\EntryPoint\getTextFormatters().

◆ getMimeAnalyzer()

MediaWiki\MediaWikiServices::getMimeAnalyzer ( )

Since: 1.28

Returns: MimeAnalyzer

Definition at line 734 of file MediaWikiServices.php.

◆ getMovePageFactory()

MediaWiki\MediaWikiServices::getMovePageFactory ( )

Since: 1.34

Returns: MovePageFactory

Definition at line 742 of file MediaWikiServices.php.

◆ getNamespaceInfo()

MediaWiki\MediaWikiServices::getNamespaceInfo ( )

Since: 1.34

Returns: NamespaceInfo

Definition at line 750 of file MediaWikiServices.php.

◆ getNameTableStoreFactory()

MediaWiki\MediaWikiServices::getNameTableStoreFactory ( )

Since: 1.32

Returns: NameTableStoreFactory

Definition at line 758 of file MediaWikiServices.php.

◆ getObjectFactory()

MediaWiki\MediaWikiServices::getObjectFactory ( )

ObjectFactory is intended for instantiating "handlers" from declarative definitions, such as Action API modules, special pages, or REST API handlers.

Since: 1.34

Returns: ObjectFactory

Definition at line 769 of file MediaWikiServices.php.

◆ getOldRevisionImporter()

MediaWiki\MediaWikiServices::getOldRevisionImporter ( )

Since: 1.32

Returns: OldRevisionImporter

Definition at line 777 of file MediaWikiServices.php.

◆ getPageEditStash()

MediaWiki\MediaWikiServices::getPageEditStash ( )

Returns: PageEditStash

Since: 1.34

Definition at line 785 of file MediaWikiServices.php.

◆ getParser()

MediaWiki\MediaWikiServices::getParser ( )

Since: 1.29

Returns: Parser

Definition at line 793 of file MediaWikiServices.php.

◆ getParserCache()

MediaWiki\MediaWikiServices::getParserCache ( )

Since: 1.30

Returns: ParserCache

Definition at line 801 of file MediaWikiServices.php.

◆ getParserFactory()

MediaWiki\MediaWikiServices::getParserFactory ( )

Since: 1.32

Returns: ParserFactory

Definition at line 809 of file MediaWikiServices.php.

◆ getPasswordFactory()

MediaWiki\MediaWikiServices::getPasswordFactory ( )

Since: 1.32

Returns: PasswordFactory

Definition at line 817 of file MediaWikiServices.php.

◆ getPerDbNameStatsdDataFactory()

MediaWiki\MediaWikiServices::getPerDbNameStatsdDataFactory ( )

Since: 1.32

Returns: StatsdDataFactoryInterface

Definition at line 825 of file MediaWikiServices.php.

◆ getPermissionManager()

MediaWiki\MediaWikiServices::getPermissionManager ( )

Since: 1.33

Returns: PermissionManager

Definition at line 833 of file MediaWikiServices.php.

◆ getPreferencesFactory()

MediaWiki\MediaWikiServices::getPreferencesFactory ( )

Since: 1.31

Returns: PreferencesFactory

Definition at line 841 of file MediaWikiServices.php.

◆ getProxyLookup()

MediaWiki\MediaWikiServices::getProxyLookup ( )

Since: 1.28

Returns: ProxyLookup

Definition at line 849 of file MediaWikiServices.php.

◆ getReadOnlyMode()

MediaWiki\MediaWikiServices::getReadOnlyMode ( )

Since: 1.29

Returns: \ReadOnlyMode

Definition at line 857 of file MediaWikiServices.php.

◆ getRepoGroup()

MediaWiki\MediaWikiServices::getRepoGroup ( )

Since: 1.34

Returns: RepoGroup

Definition at line 865 of file MediaWikiServices.php.

◆ getResourceLoader()

MediaWiki\MediaWikiServices::getResourceLoader ( )

Since: 1.33

Returns: ResourceLoader

Definition at line 873 of file MediaWikiServices.php.

◆ getRevisionFactory()

MediaWiki\MediaWikiServices::getRevisionFactory ( )

Since: 1.31

Returns: RevisionFactory

Definition at line 881 of file MediaWikiServices.php.

◆ getRevisionLookup()

MediaWiki\MediaWikiServices::getRevisionLookup ( )

Since: 1.31

Returns: RevisionLookup

Definition at line 889 of file MediaWikiServices.php.

◆ getRevisionRenderer()

MediaWiki\MediaWikiServices::getRevisionRenderer ( )

Since: 1.32

Returns: RevisionRenderer

Definition at line 897 of file MediaWikiServices.php.

◆ getRevisionStore()

MediaWiki\MediaWikiServices::getRevisionStore ( )

Since: 1.31

Returns: RevisionStore

Definition at line 905 of file MediaWikiServices.php.

◆ getRevisionStoreFactory()

MediaWiki\MediaWikiServices::getRevisionStoreFactory ( )

Since: 1.32

Returns: RevisionStoreFactory

Definition at line 913 of file MediaWikiServices.php.

◆ getSearchEngineConfig()

MediaWiki\MediaWikiServices::getSearchEngineConfig ( )

Since: 1.27

Returns: SearchEngineConfig

Definition at line 930 of file MediaWikiServices.php.

◆ getSearchEngineFactory()

MediaWiki\MediaWikiServices::getSearchEngineFactory ( )

Since: 1.27

Returns: SearchEngineFactory

Definition at line 938 of file MediaWikiServices.php.

◆ getShellCommandFactory()

MediaWiki\MediaWikiServices::getShellCommandFactory ( )

Since: 1.30

Returns: CommandFactory

Definition at line 946 of file MediaWikiServices.php.

◆ getSiteLookup()

MediaWiki\MediaWikiServices::getSiteLookup ( )

Since: 1.27

Returns: SiteLookup

Definition at line 954 of file MediaWikiServices.php.

◆ getSiteStore()

MediaWiki\MediaWikiServices::getSiteStore ( )

Since: 1.27

Returns: SiteStore

Definition at line 962 of file MediaWikiServices.php.

◆ getSkinFactory()

MediaWiki\MediaWikiServices::getSkinFactory ( )

Since: 1.27

Returns: SkinFactory

Definition at line 970 of file MediaWikiServices.php.

◆ getSlotRoleRegistry()

MediaWiki\MediaWikiServices::getSlotRoleRegistry ( )

Since: 1.33

Returns: SlotRoleRegistry

Definition at line 978 of file MediaWikiServices.php.

◆ getSlotRoleStore()

MediaWiki\MediaWikiServices::getSlotRoleStore ( )

Since: 1.31

Returns: NameTableStore

Definition at line 986 of file MediaWikiServices.php.

◆ getSpecialPageFactory()

MediaWiki\MediaWikiServices::getSpecialPageFactory ( )

Since: 1.32

Returns: SpecialPageFactory

Definition at line 994 of file MediaWikiServices.php.

◆ getStatsdDataFactory()

MediaWiki\MediaWikiServices::getStatsdDataFactory ( )

Since: 1.27

Returns: IBufferingStatsdDataFactory

Definition at line 1002 of file MediaWikiServices.php.

◆ getTempFSFileFactory()

MediaWiki\MediaWikiServices::getTempFSFileFactory ( )

Since: 1.34

Returns: TempFSFileFactory

Definition at line 1010 of file MediaWikiServices.php.

◆ getTitleFormatter()

MediaWiki\MediaWikiServices::getTitleFormatter ( )

Since: 1.28

Returns: TitleFormatter

Definition at line 1018 of file MediaWikiServices.php.

◆ getTitleParser()

MediaWiki\MediaWikiServices::getTitleParser ( )

Since: 1.28

Returns: TitleParser

Definition at line 1026 of file MediaWikiServices.php.

◆ getUploadRevisionImporter()

MediaWiki\MediaWikiServices::getUploadRevisionImporter ( )

Since: 1.32

Returns: UploadRevisionImporter

Definition at line 1034 of file MediaWikiServices.php.

◆ getVirtualRESTServiceClient()

MediaWiki\MediaWikiServices::getVirtualRESTServiceClient ( )

Since: 1.28

Returns: VirtualRESTServiceClient

Definition at line 1042 of file MediaWikiServices.php.

◆ getWatchedItemQueryService()

MediaWiki\MediaWikiServices::getWatchedItemQueryService ( )

Since: 1.28

Returns: WatchedItemQueryService

Definition at line 1050 of file MediaWikiServices.php.

◆ getWatchedItemStore()

MediaWiki\MediaWikiServices::getWatchedItemStore ( )

Since: 1.28

Returns: WatchedItemStoreInterface

Definition at line 1058 of file MediaWikiServices.php.

◆ getWikiRevisionOldRevisionImporter()

MediaWiki\MediaWikiServices::getWikiRevisionOldRevisionImporter ( )

Since: 1.31

Returns: \OldRevisionImporter

Definition at line 1066 of file MediaWikiServices.php.

◆ getWikiRevisionOldRevisionImporterNoUpdates()

MediaWiki\MediaWikiServices::getWikiRevisionOldRevisionImporterNoUpdates ( )

Since: 1.31

Returns: \OldRevisionImporter

Definition at line 1074 of file MediaWikiServices.php.

◆ getWikiRevisionUploadImporter()

MediaWiki\MediaWikiServices::getWikiRevisionUploadImporter ( )

Since: 1.31

Returns: \UploadRevisionImporter

Definition at line 1082 of file MediaWikiServices.php.

◆ newInstance()

static MediaWiki\MediaWikiServices::newInstance	(	Config	$bootstrapConfig,
			$loadWiring = `''`
	)

staticprivate

Creates a new MediaWikiServices instance and initializes it according to the given $bootstrapConfig.

In particular, all wiring files defined in the ServiceWiringFiles setting are loaded, and the MediaWikiServices hook is called.

Parameters

Config \| null	$bootstrapConfig	The Config object to be registered as the 'BootstrapConfig' service.
string	$loadWiring	set this to 'load' to load the wiring files specified in the 'ServiceWiringFiles' setting in $bootstrapConfig.

Returns: MediaWikiServices

Exceptions

MWException

Definition at line 280 of file MediaWikiServices.php.

References Config\get(), and Hooks\run().

◆ newSearchEngine()

MediaWiki\MediaWikiServices::newSearchEngine ( )

Since: 1.27

Returns: SearchEngine

Definition at line 921 of file MediaWikiServices.php.

◆ resetChildProcessServices()

static MediaWiki\MediaWikiServices::resetChildProcessServices ( )

static

Resets any services that may have become stale after a child process returns from after pcntl_fork().

It's also safe, but generally unnecessary, to call this method from the parent process.

Since: 1.28

Note: This is intended for use in the context of process forking only!

See also: resetGlobalInstance(); disableStorageBackend()

Definition at line 334 of file MediaWikiServices.php.

◆ resetGlobalInstance()

static MediaWiki\MediaWikiServices::resetGlobalInstance	(	Config	$bootstrapConfig = `null`,
			$quick = `''`
	)

static

Creates a new instance of MediaWikiServices and sets it as the global default instance.

getInstance() will return a different MediaWikiServices object after every call to resetGlobalInstance().

Since: 1.28

Warning: This should not be used during normal operation. It is intended for use when the configuration has changed significantly since bootstrap time, e.g. during the installation process or during testing.; Calling resetGlobalInstance() may leave the application in an inconsistent state. Calling this is only safe under the ASSUMPTION that NO REFERENCE to any of the services managed by MediaWikiServices exist. If any service objects managed by the old MediaWikiServices instance remain in use, they may INTERFERE with the operation of the services managed by the new MediaWikiServices. Operating with a mix of services created by the old and the new MediaWikiServices instance may lead to INCONSISTENCIES and even DATA LOSS! Any class implementing LAZY LOADING is especially prone to this problem, since instances would typically retain a reference to a storage layer service.

See also: forceGlobalInstance(); resetGlobalInstance(); resetBetweenTest()

Parameters

Config \| null	$bootstrapConfig	The Config object to be registered as the 'BootstrapConfig' service. This has to contain at least the information needed to set up the 'ConfigFactory' service. If not given, the bootstrap config of the old instance of MediaWikiServices will be re-used. If there was no previous instance, a new GlobalVarConfig object will be used to bootstrap the services.
string	$quick	Set this to "quick" to allow expensive resources to be re-used. See SalvageableService for details.

Exceptions

MWException If called after MW_SERVICE_BOOTSTRAP_COMPLETE has been defined in Setup.php (unless MW_PHPUNIT_TEST or MEDIAWIKI_INSTALL or RUN_MAINTENANCE_IF_MAIN is defined).

Definition at line 211 of file MediaWikiServices.php.

◆ resetServiceForTesting()

MediaWiki\MediaWikiServices::resetServiceForTesting	(	$name,
		$destroy = `true`
	)

Resets the given service for testing purposes.

Since: 1.28

Warning: This is generally unsafe! Other services may still retain references to the stale service instance, leading to failures and inconsistencies. Subclasses may use this method to reset specific services under specific instances, but it should not be exposed to application logic.

Note: With proper dependency injection used throughout the codebase, this method should not be needed. It is provided to allow tests that pollute global service instances to clean up.

Parameters

string	$name
bool	$destroy	Whether the service instance should be destroyed if it exists. When set to false, any existing service instance will effectively be detached from the container.

Exceptions

MWException if called outside of PHPUnit tests.

Definition at line 365 of file MediaWikiServices.php.

◆ salvage()

MediaWiki\MediaWikiServices::salvage ( self $other )

private

PhpDocSignatureInspection

Salvages the state of any salvageable service instances in $other.

Note: $other will have been destroyed when salvage() returns.

Parameters

MediaWikiServices $other

Definition at line 244 of file MediaWikiServices.php.

Member Data Documentation

◆ $instance

MediaWikiServices null MediaWiki\MediaWikiServices::$instance = null

staticprivate

Definition at line 119 of file MediaWikiServices.php.

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

includes/MediaWikiServices.php

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ disableStorageBackend()

◆ failIfResetNotAllowed()

◆ forceGlobalInstance()

◆ getActorMigration()

◆ getBadFileLookup()

◆ getBlobStore()

◆ getBlobStoreFactory()

◆ getBlockManager()

◆ getBlockRestrictionStore()

◆ getBootstrapConfig()

◆ getChangeTagDefStore()

◆ getCommentStore()

◆ getConfigFactory()

◆ getConfigRepository()

◆ getConfiguredReadOnlyMode()

◆ getContentLanguage()

◆ getContentModelStore()

◆ getCryptHKDF()

◆ getDateFormatterFactory()

◆ getDBLoadBalancer()

◆ getDBLoadBalancerFactory()

◆ getEventRelayerGroup()

◆ getExternalStoreAccess()

◆ getExternalStoreFactory()

◆ getGenderCache()

◆ getHttpRequestFactory()

◆ getInstance()

◆ getInterwikiLookup()

◆ getLinkCache()

◆ getLinkRenderer()

◆ getLinkRendererFactory()

◆ getLocalServerObjectCache()

◆ getLockManagerGroupFactory()

◆ getMagicWordFactory()

◆ getMainConfig()

◆ getMainObjectStash()

◆ getMainWANObjectCache()

◆ getMediaHandlerFactory()

◆ getMessageCache()

◆ getMessageFormatterFactory()

◆ getMimeAnalyzer()

◆ getMovePageFactory()

◆ getNamespaceInfo()

◆ getNameTableStoreFactory()

◆ getObjectFactory()

◆ getOldRevisionImporter()

◆ getPageEditStash()

◆ getParser()

◆ getParserCache()

◆ getParserFactory()

◆ getPasswordFactory()

◆ getPerDbNameStatsdDataFactory()

◆ getPermissionManager()

◆ getPreferencesFactory()

◆ getProxyLookup()

◆ getReadOnlyMode()

◆ getRepoGroup()

◆ getResourceLoader()

◆ getRevisionFactory()

◆ getRevisionLookup()

◆ getRevisionRenderer()

◆ getRevisionStore()

◆ getRevisionStoreFactory()

◆ getSearchEngineConfig()

◆ getSearchEngineFactory()

◆ getShellCommandFactory()

◆ getSiteLookup()

◆ getSiteStore()

◆ getSkinFactory()

◆ getSlotRoleRegistry()