Base class for data storage in the file system. More...

Inherited by MediaWiki\Cache\HTMLFileCache.

Collaboration diagram for MediaWiki\Cache\FileCacheBase:

Public Member Functions
	cacheTimestamp ()
	Get the last-modified timestamp of the cache file.

	clearCache ()
	Clear the cache for this page.

	fetchText ()
	Get the uncompressed text from the cache.

	getMissesRecent ()
	Roughly gets the cache misses in the last hour by unique visitors.

	incrMissesRecent (WebRequest $request)
	Roughly increments the cache misses in the last hour by unique visitors.

	isCached ()
	Check if the cache file exists.

	isCacheGood ( $timestamp='')
	Check if up to date cache file exists.

	saveText ( $text)
	Save and compress text to the cache.

Protected Member Functions
	__construct ()

	baseCacheDirectory ()
	Get the base file cache directory.

	cacheDirectory ()
	Get the base cache directory (not specific to this file)

	cacheMissKey (BagOStuff $cache)

	cachePath ()
	Get the path to the cache file.

	checkCacheDirs ()
	Create parent directors of $this->cachePath()

	hashSubdirectory ()
	Return relative multi-level hash subdirectory (with trailing slash) or the empty string if not $wgFileCacheDepth.

	typeSubdirectory ()
	Get the cache type subdirectory (with trailing slash) An extending class could use that method to alter the type -> directory mapping.

	useGzip ()
	Check if the cache is gzipped.

Protected Attributes
bool null	$mCached
	lazy loaded

string	$mExt = 'cache'

string null	$mFilePath

string	$mKey

string	$mType = 'object'

bool	$mUseGzip

ServiceOptions	$options

Detailed Description

Base class for data storage in the file system.

Definition at line 26 of file FileCacheBase.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Cache\FileCacheBase::__construct ( )

protected

Definition at line 55 of file FileCacheBase.php.

References MediaWiki\MediaWikiServices\getInstance(), and MediaWiki\MainConfigNames\UseGzip.

Member Function Documentation

◆ baseCacheDirectory()

MediaWiki\Cache\FileCacheBase::baseCacheDirectory ( )

finalprotected

Get the base file cache directory.

Returns: string

Definition at line 67 of file FileCacheBase.php.

References MediaWiki\MainConfigNames\FileCacheDirectory.

Referenced by MediaWiki\Cache\HTMLFileCache\cacheDirectory().

◆ cacheDirectory()

MediaWiki\Cache\FileCacheBase::cacheDirectory ( )

abstractprotected

Get the base cache directory (not specific to this file)

Returns: string

Reimplemented in MediaWiki\Cache\HTMLFileCache.

Referenced by MediaWiki\Cache\FileCacheBase\cachePath().

◆ cacheMissKey()

MediaWiki\Cache\FileCacheBase::cacheMissKey ( BagOStuff $cache )

protected

Parameters

BagOStuff $cache Instance that the key will be used with

Returns: string

Definition at line 283 of file FileCacheBase.php.

References Wikimedia\ObjectCache\BagOStuff\makeKey().

Referenced by MediaWiki\Cache\FileCacheBase\getMissesRecent(), and MediaWiki\Cache\FileCacheBase\incrMissesRecent().

◆ cachePath()

MediaWiki\Cache\FileCacheBase::cachePath ( )

protected

Get the path to the cache file.

Returns: string

Definition at line 81 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\$mFilePath, MediaWiki\Cache\FileCacheBase\cacheDirectory(), MediaWiki\Cache\FileCacheBase\hashSubdirectory(), MediaWiki\Cache\FileCacheBase\typeSubdirectory(), and MediaWiki\Cache\FileCacheBase\useGzip().

Referenced by MediaWiki\Cache\FileCacheBase\cacheTimestamp(), MediaWiki\Cache\FileCacheBase\checkCacheDirs(), MediaWiki\Cache\FileCacheBase\clearCache(), MediaWiki\Cache\FileCacheBase\fetchText(), MediaWiki\Cache\FileCacheBase\isCached(), MediaWiki\Cache\HTMLFileCache\loadFromFileCache(), and MediaWiki\Cache\FileCacheBase\saveText().

◆ cacheTimestamp()

MediaWiki\Cache\FileCacheBase::cacheTimestamp ( )

Get the last-modified timestamp of the cache file.

Returns: string|bool TS::MW timestamp

Definition at line 114 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\cachePath(), and wfTimestamp().

Referenced by MediaWiki\Cache\FileCacheBase\isCacheGood().

◆ checkCacheDirs()

MediaWiki\Cache\FileCacheBase::checkCacheDirs ( )

protected

Create parent directors of $this->cachePath()

Returns: void

Definition at line 203 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\cachePath(), and wfMkdirParents().

Referenced by MediaWiki\Cache\FileCacheBase\saveText().

◆ clearCache()

MediaWiki\Cache\FileCacheBase::clearCache ( )

Clear the cache for this page.

Returns: void

Definition at line 192 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\cachePath().

◆ fetchText()

MediaWiki\Cache\FileCacheBase::fetchText ( )

Get the uncompressed text from the cache.

Returns: string

Definition at line 155 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\cachePath(), and MediaWiki\Cache\FileCacheBase\useGzip().

◆ getMissesRecent()

MediaWiki\Cache\FileCacheBase::getMissesRecent ( )

Roughly gets the cache misses in the last hour by unique visitors.

Returns: int

Definition at line 272 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\cacheMissKey(), and MediaWiki\MediaWikiServices\getInstance().

◆ hashSubdirectory()

MediaWiki\Cache\FileCacheBase::hashSubdirectory ( )

protected

Return relative multi-level hash subdirectory (with trailing slash) or the empty string if not $wgFileCacheDepth.

Returns: string

Definition at line 223 of file FileCacheBase.php.

References MediaWiki\MainConfigNames\FileCacheDepth.

Referenced by MediaWiki\Cache\FileCacheBase\cachePath().

◆ incrMissesRecent()

MediaWiki\Cache\FileCacheBase::incrMissesRecent ( WebRequest $request )

Roughly increments the cache misses in the last hour by unique visitors.

Parameters

WebRequest $request

Returns: void

Definition at line 242 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\cacheMissKey(), MediaWiki\MediaWikiServices\getInstance(), and MediaWiki\Request\WebRequest\getIP().

◆ isCached()

MediaWiki\Cache\FileCacheBase::isCached ( )

Check if the cache file exists.

Returns: bool

Definition at line 104 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\$mCached, and MediaWiki\Cache\FileCacheBase\cachePath().

Referenced by MediaWiki\Cache\FileCacheBase\isCacheGood().

◆ isCacheGood()

MediaWiki\Cache\FileCacheBase::isCacheGood ( $timestamp = '' )

Check if up to date cache file exists.

Parameters

string $timestamp MW_TS timestamp

Returns: bool

Definition at line 128 of file FileCacheBase.php.

References MediaWiki\MainConfigNames\CacheEpoch, MediaWiki\Cache\FileCacheBase\cacheTimestamp(), MediaWiki\Cache\FileCacheBase\isCached(), wfBoolToStr(), and wfDebug().

◆ saveText()

MediaWiki\Cache\FileCacheBase::saveText ( $text )

Save and compress text to the cache.

Parameters

string $text

Returns: string|false Compressed text

Definition at line 170 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\cachePath(), MediaWiki\Cache\FileCacheBase\checkCacheDirs(), MediaWiki\Cache\FileCacheBase\useGzip(), and wfDebug().

Referenced by MediaWiki\Cache\HTMLFileCache\saveToFileCache().

◆ typeSubdirectory()

MediaWiki\Cache\FileCacheBase::typeSubdirectory ( )

protected

Get the cache type subdirectory (with trailing slash) An extending class could use that method to alter the type -> directory mapping.

See HTMLFileCache::typeSubdirectory for an example.

Returns: string

Reimplemented in MediaWiki\Cache\HTMLFileCache.

Definition at line 214 of file FileCacheBase.php.

Referenced by MediaWiki\Cache\FileCacheBase\cachePath().

◆ useGzip()

MediaWiki\Cache\FileCacheBase::useGzip ( )

protected

Check if the cache is gzipped.

Returns: bool

Definition at line 147 of file FileCacheBase.php.

References MediaWiki\Cache\FileCacheBase\$mUseGzip.

Referenced by MediaWiki\Cache\FileCacheBase\cachePath(), MediaWiki\Cache\FileCacheBase\fetchText(), MediaWiki\Cache\HTMLFileCache\loadFromFileCache(), MediaWiki\Cache\FileCacheBase\saveText(), and MediaWiki\Cache\HTMLFileCache\saveToFileCache().

Member Data Documentation

◆ $mCached

bool null MediaWiki\Cache\FileCacheBase::$mCached

protected

lazy loaded

Definition at line 47 of file FileCacheBase.php.

Referenced by MediaWiki\Cache\FileCacheBase\isCached().

◆ $mExt

string MediaWiki\Cache\FileCacheBase::$mExt = 'cache'

protected

Definition at line 41 of file FileCacheBase.php.

◆ $mFilePath

string null MediaWiki\Cache\FileCacheBase::$mFilePath

protected

Definition at line 43 of file FileCacheBase.php.

Referenced by MediaWiki\Cache\FileCacheBase\cachePath().

◆ $mKey

string MediaWiki\Cache\FileCacheBase::$mKey

protected

Definition at line 37 of file FileCacheBase.php.

◆ $mType

string MediaWiki\Cache\FileCacheBase::$mType = 'object'

protected

Definition at line 39 of file FileCacheBase.php.

◆ $mUseGzip

bool MediaWiki\Cache\FileCacheBase::$mUseGzip

protected

Definition at line 45 of file FileCacheBase.php.

Referenced by MediaWiki\Cache\FileCacheBase\useGzip().

◆ $options

ServiceOptions MediaWiki\Cache\FileCacheBase::$options

protected

Definition at line 49 of file FileCacheBase.php.

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

includes/Cache/FileCacheBase.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ baseCacheDirectory()

◆ cacheDirectory()

◆ cacheMissKey()

◆ cachePath()

◆ cacheTimestamp()

◆ checkCacheDirs()

◆ clearCache()

◆ fetchText()

◆ getMissesRecent()

◆ hashSubdirectory()

◆ incrMissesRecent()

◆ isCached()

◆ isCacheGood()

◆ saveText()

◆ typeSubdirectory()

◆ useGzip()

Member Data Documentation

◆ $mCached

◆ $mExt

◆ $mFilePath

◆ $mKey

◆ $mType

◆ $mUseGzip

◆ $options