MediaWiki  REL1_22
SpecialCachedPage Class Reference
Inheritance diagram for SpecialCachedPage:
Collaboration diagram for SpecialCachedPage:

List of all members.

Public Member Functions

 addCachedHTML ($computeFunction, $args=array(), $key=null)
 Add some HTML to be cached.
 getCachedValue ($computeFunction, $args=array(), $key=null)
 Get a cached value if available or compute it if not and then cache it if possible.
 onCacheInitialized ($hasCached)
 Gets called after the cache got initialized.
 saveCache ()
 Saves the HTML to the cache in case it got recomputed.
 setCacheEnabled ($cacheEnabled)
 Sets if the cache should be enabled or not.
 setExpiry ($cacheExpiry)
 Sets the time to live for the cache, in seconds or a unix timestamp indicating the point of expiry.
 startCache ($cacheExpiry=null, $cacheEnabled=null)
 Initializes the caching.

Protected Member Functions

 afterExecute ($subPage)
 Gets called after.
 getCacheKey ()
 Returns the variables used to constructed the cache key in an array.

Protected Attributes

boolean $cacheEnabled = true
 If the cache is enabled or not.
CacheHelper $cacheHelper
 CacheHelper object to which we forward the non-SpecialPage specific caching work.

Detailed Description

Definition at line 40 of file SpecialCachedPage.php.


Member Function Documentation

SpecialCachedPage::addCachedHTML ( computeFunction,
args = array(),
key = null 
)

Add some HTML to be cached.

This is done by providing a callback function that should return the HTML to be added. It will only be called if the item is not in the cache yet or when the cache has been invalidated.

Since:
1.20
Parameters:
callable$computeFunction
array$args
string | null$key

Definition at line 142 of file SpecialCachedPage.php.

SpecialCachedPage::afterExecute ( subPage) [protected]

Gets called after.

See also:
SpecialPage::execute.
Since:
1.20
Parameters:
$subPagestring|null

Reimplemented from SpecialPage.

Definition at line 64 of file SpecialCachedPage.php.

SpecialCachedPage::getCachedValue ( computeFunction,
args = array(),
key = null 
)

Get a cached value if available or compute it if not and then cache it if possible.

The provided $computeFunction is only called when the computation needs to happen and should return a result value. $args are arguments that will be passed to the compute function when called.

Since:
1.20
Parameters:
callable$computeFunction
array | mixed$args
string | null$key
Returns:
mixed

Implements ICacheHelper.

Definition at line 126 of file SpecialCachedPage.php.

Returns the variables used to constructed the cache key in an array.

Since:
1.20
Returns:
array

Definition at line 176 of file SpecialCachedPage.php.

Gets called after the cache got initialized.

Since:
1.20
Parameters:
boolean$hasCached

Definition at line 190 of file SpecialCachedPage.php.

Saves the HTML to the cache in case it got recomputed.

Should be called after the last time anything is added via addCachedHTML.

Since:
1.20

Implements ICacheHelper.

Definition at line 152 of file SpecialCachedPage.php.

Sets if the cache should be enabled or not.

Since:
1.20
Parameters:
boolean$cacheEnabled

Implements ICacheHelper.

Definition at line 76 of file SpecialCachedPage.php.

SpecialCachedPage::setExpiry ( cacheExpiry)

Sets the time to live for the cache, in seconds or a unix timestamp indicating the point of expiry.

Since:
1.20
Parameters:
integer$cacheExpiry

Implements ICacheHelper.

Definition at line 165 of file SpecialCachedPage.php.

SpecialCachedPage::startCache ( cacheExpiry = null,
cacheEnabled = null 
)

Initializes the caching.

Should be called before the first time anything is added via addCachedHTML.

Since:
1.20
Parameters:
integer | null$cacheExpirySets the cache expiry, either ttl in seconds or unix timestamp.
boolean | null$cacheEnabledSets if the cache should be enabled or not.

Implements ICacheHelper.

Definition at line 89 of file SpecialCachedPage.php.


Member Data Documentation

boolean SpecialCachedPage::$cacheEnabled = true [protected]

If the cache is enabled or not.

Since:
1.20

Definition at line 55 of file SpecialCachedPage.php.

CacheHelper SpecialCachedPage::$cacheHelper [protected]

CacheHelper object to which we forward the non-SpecialPage specific caching work.

Initialized in startCache.

Since:
1.20

Definition at line 48 of file SpecialCachedPage.php.


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