Class for managing the deferred updates. More...

Collaboration diagram for DeferredUpdates:

Static Public Member Functions
static	addCallableUpdate ($callable, $type=self::POSTSEND)
	Add a callable update. More...

static	addUpdate (DeferrableUpdate $update, $type=self::POSTSEND)
	Add an update to the deferred list. More...

static	clearPendingUpdates ()
	Clear all pending updates without performing them. More...

static	doUpdates ($mode= 'run', $type=self::ALL)
	Do any deferred updates and clear the list. More...

static	execute (array &$queue, $mode)

Public Attributes
const	ALL = 0

const	POSTSEND = 2

const	PRESEND = 1

Static Private Member Functions
static	push (array &$queue, DeferrableUpdate $update)

Static Private Attributes
static DeferrableUpdate[]	$postSendUpdates = []
	Updates to be deferred until after request end. More...

static DeferrableUpdate[]	$preSendUpdates = []
	Updates to be deferred until before request end. More...

Detailed Description

Class for managing the deferred updates.

In web request mode, deferred updates can be run at the end of the request, either before or after the HTTP response has been sent. In either case, they run after the DB commit step. If an update runs after the response is sent, it will not block clients. If sent before, it will run synchronously. If such an update works via queueing, it will be more likely to complete by the time the client makes their next request after this one.

In CLI mode, updates are only deferred until the current wiki has no DB write transaction active within this request.

When updates are deferred, they use a FIFO queue (one for pre-send and one for post-send).

Since: 1.19

Definition at line 39 of file DeferredUpdates.php.

Member Function Documentation

static DeferredUpdates::addCallableUpdate	(	$callable,
		$type = `self::POSTSEND`
	)

static

Add a callable update.

In a lot of cases, we just need a callback/closure, defining a new DeferrableUpdate object is not necessary

See also: MWCallableUpdate::__construct()

Parameters

callable	$callable
integer	$type	DeferredUpdates constant (PRESEND or POSTSEND) (since 1.27)

Definition at line 72 of file DeferredUpdates.php.

References $type.

Referenced by User\clearNotification(), FileBackendMultiWrite\doDirectoryOp(), WikiPage\doEditContent(), FileBackendMultiWrite\doOperationsInternal(), FileBackendMultiWrite\doQuickOperationsInternal(), EditPage\edit(), MovePageForm\execute(), CategoryViewer\getCountMessage(), MediaWiki\Logger\Monolog\BufferHandler\handle(), WikiPage\insertRedirect(), RecentChange\notifyEdit(), RecentChange\notifyNew(), WikiPage\onArticleEdit(), SpecialSearch\saveNamespaces(), DeferredUpdatesTest\testDoUpdatesCLI(), DeferredUpdatesTest\testDoUpdatesWeb(), and EditPage\updateWatchlist().

static DeferredUpdates::addUpdate	(	DeferrableUpdate	$update,
			$type = `self::POSTSEND`
	)

static

Add an update to the deferred list.

Parameters

DeferrableUpdate	$update	Some object that implements doUpdate()
integer	$type	DeferredUpdates constant (PRESEND or POSTSEND) (since 1.27)

Definition at line 55 of file DeferredUpdates.php.

References $type.

Referenced by MediaWiki\Auth\AuthManager\autoCreateUser(), MediaWiki\Auth\AuthManager\continueAccountCreation(), LocalFile\delete(), LocalFile\deleteOld(), WikiPage\doDeleteUpdates(), WikiPage\doEditUpdates(), RevDelFileList\doPostCommitUpdates(), WikiFilePage\doPurge(), WikiPage\doPurge(), LocalFileRestoreBatch\execute(), WikiImporter\finishImportPage(), LinksUpdate\invalidateProperties(), WikiPage\onArticleDelete(), WikiPage\onArticleEdit(), LocalFile\purgeCache(), File\purgeEverything(), Block\purgeExpired(), Title\purgeExpiredRestrictions(), LocalFile\purgeOldThumbnails(), Title\purgeSquid(), LocalFile\purgeThumbnails(), LocalFile\recordUpload2(), CdnCacheUpdateTest\testPurgeMergeWeb(), Title\touchLinks(), and PageArchive\undeleteRevisions().

static DeferredUpdates::clearPendingUpdates ( )

static

Clear all pending updates without performing them.

Generally, you don't want or need to call this. Unit tests need it though.

Definition at line 173 of file DeferredUpdates.php.

Referenced by UploadFromUrlTestSuite\setUp(), ParserTest\setUp(), and MediaWikiTestCase\setUp().

static DeferredUpdates::doUpdates	(	$mode = `'run'`,
		$type = `self::ALL`
	)

static

Do any deferred updates and clear the list.

Parameters

string	$mode	Use "enqueue" to use the job queue when possible [Default: "run"]
integer	$type	DeferredUpdates constant (PRESEND, POSTSEND, or ALL) (since 1.27)

Definition at line 82 of file DeferredUpdates.php.

References $type, and execute().

Referenced by JobRunner\executeJob(), MediaWiki\preOutputCommit(), push(), MediaWiki\restInPeace(), FileBackendTest\testAsyncWrites(), DeferredUpdatesTest\testDoUpdatesCLI(), DeferredUpdatesTest\testDoUpdatesWeb(), and BagOStuffTest\testReportDupes().