MediaWiki master
|
Parser cache specific expiry check. More...
Inherits MediaWiki\Parser\ParserCacheMetadata, and MediaWiki\Json\JsonDeserializable.
Inherited by MediaWiki\Parser\ParserOutput.
Public Member Functions | |
__get ( $name) | |
__set ( $name, $value) | |
__wakeup () | |
expired ( $touched) | |
Return true if this cached output object predates the global or per-article cache invalidation timestamps, or if it comes from an incompatible older version. | |
getCacheExpiry () | |
Returns the number of seconds after which this object should expire. | |
getCacheRevisionId () | |
getCacheTime () | |
getUsedOptions () | |
Returns the options from its ParserOptions which have been taken into account to produce the output. | |
hasCacheTime () | |
isCacheable () | |
isDifferentRevision ( $id) | |
Return true if this cached output object is for a different revision of the page. | |
recordOption (string $option) | |
Tags a parser option for use in the cache key for this parser output. | |
recordOptions (array $options) | |
Tags a list of parser option names for use in the cache key for this parser output. | |
setCacheRevisionId ( $id) | |
setCacheTime ( $t) | |
setCacheTime() sets the timestamp expressing when the page has been rendered. | |
updateCacheExpiry ( $seconds) | |
Sets the number of seconds after which this object should expire. | |
Static Public Member Functions | |
static | newFromJsonArray (JsonDeserializer $deserializer, array $json) |
Creates a new instance of the class and initialized it from the $json array. | |
Protected Member Functions | |
initFromJson (JsonDeserializer $deserializer, array $jsonData) | |
Initialize member fields from an array returned by jsonSerialize(). | |
toJsonArray () | |
Returns a JSON serializable structure representing this CacheTime instance. | |
Protected Attributes | |
int null | $mCacheExpiry = null |
Seconds after which the object should expire, use 0 for not cacheable. | |
int null | $mCacheRevisionId = null |
Revision ID that was parsed. | |
string int | $mCacheTime = '' |
TS_MW timestamp when this object was generated, or -1 for not cacheable. | |
true[] | $mParseUsedOptions = [] |
ParserOptions which have been taken into account to produce output, option names stored in array keys. | |
Parser cache specific expiry check.
Definition at line 38 of file CacheTime.php.
CacheTime::__get | ( | $name | ) |
Reimplemented in MediaWiki\Parser\ParserOutput.
Definition at line 302 of file CacheTime.php.
References wfDeprecatedMsg().
CacheTime::__set | ( | $name, | |
$value ) |
Reimplemented in MediaWiki\Parser\ParserOutput.
Definition at line 317 of file CacheTime.php.
References wfDeprecatedMsg().
CacheTime::__wakeup | ( | ) |
Reimplemented in MediaWiki\Parser\ParserOutput.
Definition at line 294 of file CacheTime.php.
CacheTime::expired | ( | $touched | ) |
Return true if this cached output object predates the global or per-article cache invalidation timestamps, or if it comes from an incompatible older version.
string | $touched | The affected article's last touched timestamp |
Definition at line 180 of file CacheTime.php.
CacheTime::getCacheExpiry | ( | ) |
Returns the number of seconds after which this object should expire.
This method is used by ParserCache to determine how long the ParserOutput can be cached. The timestamp of expiry can be calculated by adding getCacheExpiry() to getCacheTime(). The value returned by getCacheExpiry is smaller or equal to the smallest number that was provided to a call of updateCacheExpiry(), and smaller or equal to the value of $wgParserCacheExpireTime.
Implements MediaWiki\Parser\ParserCacheMetadata.
Definition at line 152 of file CacheTime.php.
Referenced by MediaWiki\Parser\Parsoid\ParsoidParser\makeLimitReport(), MediaWiki\Parser\RevisionOutputCache\save(), ParserCache\save(), and WikiPage\triggerOpportunisticLinksUpdate().
CacheTime::getCacheRevisionId | ( | ) |
Implements MediaWiki\Parser\ParserCacheMetadata.
Definition at line 106 of file CacheTime.php.
Referenced by MediaWiki\Parser\RevisionOutputCache\save(), and ParserCache\save().
CacheTime::getCacheTime | ( | ) |
Implements MediaWiki\Parser\ParserCacheMetadata.
Definition at line 68 of file CacheTime.php.
Referenced by MediaWiki\Parser\Parsoid\ParsoidParser\makeLimitReport(), MediaWiki\Parser\RevisionOutputCache\save(), ParserCache\save(), and WikiPage\triggerOpportunisticLinksUpdate().
CacheTime::getUsedOptions | ( | ) |
Returns the options from its ParserOptions which have been taken into account to produce the output.
Implements MediaWiki\Parser\ParserCacheMetadata.
Definition at line 214 of file CacheTime.php.
Referenced by MediaWiki\Parser\ParserObserver\notifyParse(), and ParserCache\save().
CacheTime::hasCacheTime | ( | ) |
Definition at line 79 of file CacheTime.php.
Referenced by ParserCache\save().
|
protected |
Initialize member fields from an array returned by jsonSerialize().
JsonDeserializer | $deserializer | Unused |
array | $jsonData |
Reimplemented in MediaWiki\Parser\ParserOutput.
Definition at line 276 of file CacheTime.php.
CacheTime::isCacheable | ( | ) |
Definition at line 168 of file CacheTime.php.
Referenced by MediaWiki\Output\OutputPage\addParserOutputMetadata().
CacheTime::isDifferentRevision | ( | $id | ) |
Return true if this cached output object is for a different revision of the page.
int | $id | The affected article's current revision id |
Definition at line 203 of file CacheTime.php.
|
static |
Creates a new instance of the class and initialized it from the $json array.
JsonDeserializer | $deserializer | an instance of JsonDeserializer to use for nested properties if they need special care. |
array | $json |
Implements MediaWiki\Json\JsonDeserializable.
Reimplemented in MediaWiki\Parser\ParserOutput.
Definition at line 265 of file CacheTime.php.
CacheTime::recordOption | ( | string | $option | ) |
Tags a parser option for use in the cache key for this parser output.
Registered as a watcher at ParserOptions::registerWatcher() by Parser::clearState(). The information gathered here is available via getUsedOptions(), and is used by ParserCache::save().
string | $option |
Definition at line 230 of file CacheTime.php.
CacheTime::recordOptions | ( | array | $options | ) |
Tags a list of parser option names for use in the cache key for this parser output.
string[] | $options |
Definition at line 240 of file CacheTime.php.
Referenced by ParserCache\save().
CacheTime::setCacheRevisionId | ( | $id | ) |
int | null | $id | Revision ID |
Definition at line 114 of file CacheTime.php.
Referenced by MediaWiki\Parser\RevisionOutputCache\save(), and ParserCache\save().
CacheTime::setCacheTime | ( | $t | ) |
setCacheTime() sets the timestamp expressing when the page has been rendered.
This does not control expiry, see updateCacheExpiry() for that!
string | $t | TS_MW timestamp |
Definition at line 89 of file CacheTime.php.
References wfDeprecatedMsg(), and wfSetVar().
Referenced by MediaWiki\Parser\RevisionOutputCache\save(), and ParserCache\save().
|
protected |
Returns a JSON serializable structure representing this CacheTime instance.
Reimplemented in MediaWiki\Parser\ParserOutput.
Definition at line 253 of file CacheTime.php.
CacheTime::updateCacheExpiry | ( | $seconds | ) |
Sets the number of seconds after which this object should expire.
This value is used with the ParserCache. If called with a value greater than the value provided at any previous call, the new call has no effect. The value returned by getCacheExpiry is smaller or equal to the smallest number that was provided as an argument to updateCacheExpiry().
Avoid using 0 if at all possible. Consider JavaScript for highly dynamic content.
NOTE: Beware that reducing the TTL for reasons that do not relate to "dynamic content", may have the side-effect of incurring more RefreshLinksJob executions. See also WikiPage::triggerOpportunisticLinksUpdate.
int | $seconds |
Definition at line 135 of file CacheTime.php.
Referenced by MediaWiki\Parser\RevisionOutputCache\save().
|
protected |
Seconds after which the object should expire, use 0 for not cacheable.
Used in ParserCache.
Definition at line 58 of file CacheTime.php.
|
protected |
Revision ID that was parsed.
Definition at line 63 of file CacheTime.php.
|
protected |
TS_MW timestamp when this object was generated, or -1 for not cacheable.
Used in ParserCache.
Definition at line 52 of file CacheTime.php.
|
protected |
ParserOptions which have been taken into account to produce output, option names stored in array keys.
Definition at line 46 of file CacheTime.php.