MediaWiki  1.30.0
CacheTime Class Reference

Parser cache specific expiry check. More...

Inheritance diagram for CacheTime:

Public Member Functions

 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. More...
 
 getCacheExpiry ()
 Returns the number of seconds after which this object should expire. More...
 
 getCacheRevisionId ()
 
 getCacheTime ()
 
 isCacheable ()
 
 isDifferentRevision ( $id)
 Return true if this cached output object is for a different revision of the page. More...
 
 setCacheRevisionId ( $id)
 
 setCacheTime ( $t)
 setCacheTime() sets the timestamp expressing when the page has been rendered. More...
 
 updateCacheExpiry ( $seconds)
 Sets the number of seconds after which this object should expire. More...
 

Public Attributes

 $mCacheExpiry = null
 
 $mCacheRevisionId = null
 
 $mCacheTime = ''
 
array bool $mUsedOptions
 ParserOptions which have been taken into account to produce output or false if not available. More...
 
 $mVersion = Parser::VERSION
 

Detailed Description

Parser cache specific expiry check.

Definition at line 29 of file CacheTime.php.

Member Function Documentation

◆ expired()

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.

Parameters
string$touchedThe affected article's last touched timestamp
Returns
bool

Definition at line 147 of file CacheTime.php.

References $wgCacheEpoch, getCacheExpiry(), getCacheTime(), global, isCacheable(), and wfTimestamp().

◆ getCacheExpiry()

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.

Returns
int|mixed|null

Definition at line 110 of file CacheTime.php.

References $mCacheExpiry, $wgParserCacheExpireTime, and global.

Referenced by ApiStashEdit\buildStashValue(), expired(), ParserOutput\hasDynamicContent(), isCacheable(), and WikiPage\triggerOpportunisticLinksUpdate().

◆ getCacheRevisionId()

CacheTime::getCacheRevisionId ( )
Since
1.23
Returns
int|null Revision id, if any was set

Definition at line 68 of file CacheTime.php.

References $mCacheRevisionId.

Referenced by isDifferentRevision().

◆ getCacheTime()

CacheTime::getCacheTime ( )
Returns
string TS_MW timestamp

Definition at line 50 of file CacheTime.php.

References wfTimestamp().

Referenced by expired(), and WikiPage\triggerOpportunisticLinksUpdate().

◆ isCacheable()

CacheTime::isCacheable ( )
Returns
bool

Definition at line 135 of file CacheTime.php.

References getCacheExpiry().

Referenced by expired().

◆ isDifferentRevision()

CacheTime::isDifferentRevision (   $id)

Return true if this cached output object is for a different revision of the page.

Todo:
We always return false if $this->getCacheRevisionId() is null; this prevents invalidating the whole parser cache when this change is deployed. Someday that should probably be changed.
Since
1.23
Parameters
int$idThe affected article's current revision id
Returns
bool

Definition at line 171 of file CacheTime.php.

References getCacheRevisionId().

◆ setCacheRevisionId()

CacheTime::setCacheRevisionId (   $id)
Since
1.23
Parameters
int$idRevision id

Definition at line 76 of file CacheTime.php.

◆ setCacheTime()

CacheTime::setCacheTime (   $t)

setCacheTime() sets the timestamp expressing when the page has been rendered.

This does not control expiry, see updateCacheExpiry() for that!

Parameters
string$tTS_MW timestamp
Returns
string

Definition at line 60 of file CacheTime.php.

References $t, and wfSetVar().

◆ updateCacheExpiry()

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.

Parameters
int$seconds

Definition at line 93 of file CacheTime.php.

Referenced by ParserOutput\finalizeAdaptiveCacheExpiry(), ParserCache\save(), and ParserOutput\updateRuntimeAdaptiveExpiry().

Member Data Documentation

◆ $mCacheExpiry

CacheTime::$mCacheExpiry = null

Definition at line 42 of file CacheTime.php.

Referenced by getCacheExpiry().

◆ $mCacheRevisionId

CacheTime::$mCacheRevisionId = null

Definition at line 45 of file CacheTime.php.

Referenced by getCacheRevisionId().

◆ $mCacheTime

CacheTime::$mCacheTime = ''

Definition at line 39 of file CacheTime.php.

◆ $mUsedOptions

array bool CacheTime::$mUsedOptions

ParserOptions which have been taken into account to produce output or false if not available.

Definition at line 33 of file CacheTime.php.

◆ $mVersion

CacheTime::$mVersion = Parser::VERSION

Definition at line 36 of file CacheTime.php.


The documentation for this class was generated from the following file: