The MediaWiki class is the helper class for the index.php entry point. More...

Classes
class	MediaWikiServices
	Service locator for MediaWiki core services. More...

Public Member Functions
	__construct (IContextSource $context=null)

	doPostOutputShutdown ()
	This function does work that can be done after the user gets the HTTP response so they don't block on it. More...

	getAction ()
	Returns the name of the action that will be executed. More...

	getTitle ()
	Get the Title object that we'll be acting on, as specified in the WebRequest. More...

	restInPeace ()
	Ends this task peacefully. More...

	run ()
	Run the current MediaWiki instance; index.php just calls this. More...

Static Public Member Functions
static	emitBufferedStatsdData (IBufferingStatsdDataFactory $stats, Config $config)
	Send out any buffered statsd data according to sampling rules. More...

static	preOutputCommit (IContextSource $context)
	This function commits all DB and session changes as needed before the client can receive a response (in case DB commit fails) and thus also before the response can trigger a subsequent related request by the client. More...

Detailed Description

The MediaWiki class is the helper class for the index.php entry point.

Definition at line 50 of file MediaWiki.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki::__construct ( IContextSource $context = null )

Parameters

IContextSource | null $context

Definition at line 70 of file MediaWiki.php.

References RequestContext\getMain().

Referenced by MediaWiki\Html\HtmlHelper\modifyElements().

Member Function Documentation

◆ doPostOutputShutdown()

MediaWiki::doPostOutputShutdown ( )

This function does work that can be done after the user gets the HTTP response so they don't block on it.

This manages deferred updates, job insertion, final commit, and the logging of profiling data

Since: 1.26

Definition at line 859 of file MediaWiki.php.

References MWExceptionHandler\rollbackPrimaryChangesAndLog().

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

◆ emitBufferedStatsdData()

static MediaWiki::emitBufferedStatsdData	(	IBufferingStatsdDataFactory	$stats,
		Config	$config
	)

static

Send out any buffered statsd data according to sampling rules.

For web requests, this is called once by MediaWiki::restInPeace(), which is post-send (after the response is sent to the client).

For maintenance scripts, especially long-running CLI scripts, it is called more often, to avoid OOM, since we buffer stats (T181385), based on the following heuristics:

Long-running scripts that involve database writes often use transactions to commit chunks of work. We flush from IDatabase::setTransactionListener, as wired up by MWLBFactory::applyGlobalState.
Long-running scripts that involve database writes but don't need any transactions will still periodically wait for replication to be graceful to the databases. We flush from ILBFactory::setWaitForReplicationListener as wired up by MWLBFactory::applyGlobalState.
Any other long-running scripts will probably report progress to stdout in some way. We also flush from Maintenance::output().

Parameters

IBufferingStatsdDataFactory	$stats
Config	$config

Exceptions

ConfigException

Since: 1.31

Definition at line 1217 of file MediaWiki.php.

References IBufferingStatsdDataFactory\clearData(), MediaWiki\Config\Config\get(), IBufferingStatsdDataFactory\getData(), IBufferingStatsdDataFactory\hasData(), and MWExceptionHandler\logException().

Referenced by MWLBFactory\applyGlobalState(), and Maintenance\output().

◆ getAction()

MediaWiki::getAction ( )

Returns the name of the action that will be executed.

Returns: string Action

Definition at line 202 of file MediaWiki.php.

◆ getTitle()

MediaWiki::getTitle ( )

Get the Title object that we'll be acting on, as specified in the WebRequest.

Returns: Title

Definition at line 186 of file MediaWiki.php.

Referenced by MediaWiki\Specials\SpecialUpload\getExistsWarning(), MediaWiki\Specials\SpecialBlock\postHtml(), MediaWiki\Specials\SpecialMovePage\showForm(), and MediaWiki\Specials\SpecialRevisionDelete\showForm().

◆ preOutputCommit()

static MediaWiki::preOutputCommit ( IContextSource $context )

static

This function commits all DB and session changes as needed before the client can receive a response (in case DB commit fails) and thus also before the response can trigger a subsequent related request by the client.

Parameters

IContextSource $context