2020-03-03 22:50:34 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace MediaWiki\Hook;
|
|
|
|
|
|
2020-03-16 23:31:05 +00:00
|
|
|
use ParserOptions;
|
|
|
|
|
use ParserOutput;
|
|
|
|
|
use WikiPage;
|
|
|
|
|
|
2020-03-03 22:50:34 +00:00
|
|
|
/**
|
2020-09-26 13:18:43 +00:00
|
|
|
* This is a hook handler interface, see docs/Hooks.md.
|
|
|
|
|
* Use the hook name "RejectParserCacheValue" to register handlers implementing this interface.
|
|
|
|
|
*
|
2020-07-13 09:05:49 +00:00
|
|
|
* @stable to implement
|
2020-03-03 22:50:34 +00:00
|
|
|
* @ingroup Hooks
|
|
|
|
|
*/
|
|
|
|
|
interface RejectParserCacheValueHook {
|
|
|
|
|
/**
|
2020-03-16 23:31:05 +00:00
|
|
|
* Use this hook to reject an otherwise usable cached value from the Parser cache.
|
|
|
|
|
* NOTE: CARELESS USE OF THIS HOOK CAN HAVE CATASTROPHIC CONSEQUENCES
|
|
|
|
|
* FOR HIGH-TRAFFIC INSTALLATIONS. USE WITH EXTREME CARE.
|
2020-03-03 22:50:34 +00:00
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
*
|
2020-03-16 23:31:05 +00:00
|
|
|
* @param ParserOutput $parserOutput ParserOutput value
|
|
|
|
|
* @param WikiPage $wikiPage
|
|
|
|
|
* @param ParserOptions $parserOptions
|
|
|
|
|
* @return bool|void True or no return value to continue, or false to reject
|
|
|
|
|
* an otherwise usable cached value from the Parser cache
|
2020-03-03 22:50:34 +00:00
|
|
|
*/
|
|
|
|
|
public function onRejectParserCacheValue( $parserOutput, $wikiPage,
|
|
|
|
|
$parserOptions
|
|
|
|
|
);
|
|
|
|
|
}
|