composer: * mediawiki/mediawiki-codesniffer: 36.0.0 → 37.0.0 The following sniffs now pass and were enabled: * Generic.ControlStructures.InlineControlStructure * MediaWiki.PHPUnit.AssertCount.NotUsed npm: * svgo: 2.3.0 → 2.3.1 * https://npmjs.com/advisories/1754 (CVE-2021-33587) Change-Id: I2a9bbee2fecbf7259876d335f565ece4b3622426
30 lines
1.1 KiB
PHP
30 lines
1.1 KiB
PHP
<?php
|
|
|
|
namespace MediaWiki\Api\Hook;
|
|
|
|
/**
|
|
* This is a hook handler interface, see docs/Hooks.md.
|
|
* Use the hook name "ApiMaxLagInfo" to register handlers implementing this interface.
|
|
*
|
|
* @stable to implement
|
|
* @ingroup Hooks
|
|
*/
|
|
interface ApiMaxLagInfoHook {
|
|
/**
|
|
* This hook is called when lag information is being requested via API. Use this hook
|
|
* to override lag information. Generally a hook function should only replace
|
|
* $lagInfo if the new $lagInfo['lag'] is greater than the current $lagInfo['lag'].
|
|
*
|
|
* @since 1.35
|
|
*
|
|
* @param array &$lagInfo Maximum lag information array. Fields in the array are:
|
|
* - `lag`: number of seconds of lag
|
|
* - `host`: host name on which the lag exists
|
|
* - `type`: an indication of the type of lag. For example: "db" for database
|
|
* replication lag or "jobqueue" for job queue size converted to pseudo-seconds
|
|
*
|
|
* You can also add more fields that are returned to the user in the API response.
|
|
* @return void This hook must not abort, it must return no value
|
|
*/
|
|
public function onApiMaxLagInfo( &$lagInfo ): void;
|
|
}
|