MediaWiki  1.34.0
CachedAction.php
Go to the documentation of this file.
1 <?php
46 abstract class CachedAction extends FormlessAction implements ICacheHelper {
47 
55  protected $cacheHelper;
56 
63  protected $cacheEnabled = true;
64 
71  public function setCacheEnabled( $cacheEnabled ) {
72  $this->cacheHelper->setCacheEnabled( $cacheEnabled );
73  }
74 
84  public function startCache( $cacheExpiry = null, $cacheEnabled = null ) {
85  $this->cacheHelper = new CacheHelper();
86 
87  $this->cacheHelper->setCacheEnabled( $this->cacheEnabled );
88  $this->cacheHelper->setOnInitializedHandler( [ $this, 'onCacheInitialized' ] );
89 
90  $keyArgs = $this->getCacheKey();
91 
92  if ( array_key_exists( 'action', $keyArgs ) && $keyArgs['action'] === 'purge' ) {
93  unset( $keyArgs['action'] );
94  }
95 
96  $this->cacheHelper->setCacheKey( $keyArgs );
97 
98  if ( $this->getRequest()->getText( 'action' ) === 'purge' ) {
99  $this->cacheHelper->rebuildOnDemand();
100  }
101 
102  $this->cacheHelper->startCache( $cacheExpiry, $cacheEnabled );
103  }
104 
119  public function getCachedValue( $computeFunction, $args = [], $key = null ) {
120  return $this->cacheHelper->getCachedValue( $computeFunction, $args, $key );
121  }
122 
135  public function addCachedHTML( $computeFunction, $args = [], $key = null ) {
136  $html = $this->cacheHelper->getCachedValue( $computeFunction, $args, $key );
137  $this->getOutput()->addHTML( $html );
138  }
139 
146  public function saveCache() {
147  $this->cacheHelper->saveCache();
148  }
149 
158  public function setExpiry( $cacheExpiry ) {
159  $this->cacheHelper->setExpiry( $cacheExpiry );
160  }
161 
169  protected function getCacheKey() {
170  return [
171  get_class( $this->page ),
172  $this->getName(),
173  $this->getLanguage()->getCode()
174  ];
175  }
176 
184  public function onCacheInitialized( $hasCached ) {
185  if ( $hasCached ) {
186  $this->getOutput()->setSubtitle( $this->cacheHelper->getCachedNotice( $this->getContext() ) );
187  }
188  }
189 }
CachedAction\onCacheInitialized
onCacheInitialized( $hasCached)
Gets called after the cache got initialized.
Definition: CachedAction.php:184
CachedAction\saveCache
saveCache()
Saves the HTML to the cache in case it got recomputed.
Definition: CachedAction.php:146
CachedAction\getCachedValue
getCachedValue( $computeFunction, $args=[], $key=null)
Get a cached value if available or compute it if not and then cache it if possible.
Definition: CachedAction.php:119
FormlessAction
An action which just does something, without showing a form first.
Definition: FormlessAction.php:28
Action\getRequest
getRequest()
Get the WebRequest being used for this instance.
Definition: Action.php:198
CachedAction\getCacheKey
getCacheKey()
Returns the variables used to constructed the cache key in an array.
Definition: CachedAction.php:169
CachedAction\setCacheEnabled
setCacheEnabled( $cacheEnabled)
Sets if the cache should be enabled or not.
Definition: CachedAction.php:71
Action\getName
getName()
Return the name of the action this object responds to.
ICacheHelper
Interface for all classes implementing CacheHelper functionality.
Definition: ICacheHelper.php:30
CachedAction
Abstract action class with scaffolding for caching HTML and other values in a single blob.
Definition: CachedAction.php:46
CachedAction\$cacheEnabled
bool $cacheEnabled
If the cache is enabled or not.
Definition: CachedAction.php:63
CachedAction\addCachedHTML
addCachedHTML( $computeFunction, $args=[], $key=null)
Add some HTML to be cached.
Definition: CachedAction.php:135
CachedAction\setExpiry
setExpiry( $cacheExpiry)
Sets the time to live for the cache, in seconds or a unix timestamp indicating the point of expiry.
Definition: CachedAction.php:158
CacheHelper
Helper class for caching various elements in a single cache entry.
Definition: CacheHelper.php:45
$args
if( $line===false) $args
Definition: cdb.php:64
CachedAction\$cacheHelper
CacheHelper $cacheHelper
CacheHelper object to which we forward the non-SpecialPage specific caching work.
Definition: CachedAction.php:55
Action\getLanguage
getLanguage()
Shortcut to get the user Language being used for this instance.
Definition: Action.php:237
CachedAction\startCache
startCache( $cacheExpiry=null, $cacheEnabled=null)
Initializes the caching.
Definition: CachedAction.php:84
Action\getOutput
getOutput()
Get the OutputPage being used for this instance.
Definition: Action.php:208