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

Collaboration diagram for 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

	$mExt = 'cache'

	$mFilePath

	$mKey

	$mType = 'object'

	$mUseGzip

ServiceOptions	$options

Detailed Description

Base class for data storage in the file system.

Definition at line 36 of file FileCacheBase.php.

Constructor & Destructor Documentation

◆ __construct()

FileCacheBase::__construct ( )

protected

Definition at line 60 of file FileCacheBase.php.

Member Function Documentation

◆ baseCacheDirectory()

FileCacheBase::baseCacheDirectory ( )

finalprotected

Get the base file cache directory.

Returns: string

Definition at line 72 of file FileCacheBase.php.

Referenced by HTMLFileCache\cacheDirectory().

◆ cacheDirectory()

FileCacheBase::cacheDirectory ( )

abstractprotected

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

Returns: string

Reimplemented in HTMLFileCache.

Referenced by cachePath().

◆ cacheMissKey()

FileCacheBase::cacheMissKey ( BagOStuff $cache )

protected

Parameters

BagOStuff $cache Instance that the key will be used with

Returns: string

Definition at line 286 of file FileCacheBase.php.

References BagOStuff\makeKey().

Referenced by getMissesRecent(), and incrMissesRecent().

◆ cachePath()

FileCacheBase::cachePath ( )

protected

Get the path to the cache file.

Returns: string

Definition at line 86 of file FileCacheBase.php.

References $mFilePath, cacheDirectory(), hashSubdirectory(), typeSubdirectory(), and useGzip().

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

◆ cacheTimestamp()

FileCacheBase::cacheTimestamp ( )

Get the last-modified timestamp of the cache file.

Returns: string|bool TS_MW timestamp

Definition at line 119 of file FileCacheBase.php.

References cachePath(), and wfTimestamp().

Referenced by isCacheGood().

◆ checkCacheDirs()

FileCacheBase::checkCacheDirs ( )

protected

Create parent directors of $this->cachePath()

Returns: void

Definition at line 208 of file FileCacheBase.php.

References cachePath(), and wfMkdirParents().

Referenced by saveText().

◆ clearCache()

FileCacheBase::clearCache ( )

Clear the cache for this page.

Returns: void

Definition at line 197 of file FileCacheBase.php.

References cachePath().

◆ fetchText()

FileCacheBase::fetchText ( )

Get the uncompressed text from the cache.

Returns: string

Definition at line 160 of file FileCacheBase.php.

References cachePath(), and useGzip().

◆ getMissesRecent()

FileCacheBase::getMissesRecent ( )

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

Returns: int

Definition at line 276 of file FileCacheBase.php.

References cacheMissKey().

◆ hashSubdirectory()

FileCacheBase::hashSubdirectory ( )

protected

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

Returns: string

Definition at line 228 of file FileCacheBase.php.

Referenced by cachePath().

◆ incrMissesRecent()

FileCacheBase::incrMissesRecent ( WebRequest $request )

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

Parameters

WebRequest $request

Returns: void

Definition at line 247 of file FileCacheBase.php.

References cacheMissKey(), and MediaWiki\Request\WebRequest\getIP().

◆ isCached()

FileCacheBase::isCached ( )

Check if the cache file exists.

Returns: bool

Definition at line 109 of file FileCacheBase.php.

References $mCached, and cachePath().

Referenced by isCacheGood().

◆ isCacheGood()

FileCacheBase::isCacheGood ( $timestamp = '' )

Check if up to date cache file exists.

Parameters

string $timestamp MW_TS timestamp

Returns: bool

Definition at line 133 of file FileCacheBase.php.

References cacheTimestamp(), isCached(), wfBoolToStr(), and wfDebug().

◆ saveText()

FileCacheBase::saveText ( $text )

Save and compress text to the cache.

Parameters

string $text

Returns: string|false Compressed text

Definition at line 175 of file FileCacheBase.php.

References cachePath(), checkCacheDirs(), useGzip(), and wfDebug().

Referenced by HTMLFileCache\saveToFileCache().

◆ typeSubdirectory()

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 also: HTMLFileCache::typeSubdirectory() for an example.

Returns: string

Reimplemented in HTMLFileCache.

Definition at line 219 of file FileCacheBase.php.

Referenced by cachePath().

◆ useGzip()

FileCacheBase::useGzip ( )

protected

Check if the cache is gzipped.

Returns: bool

Definition at line 152 of file FileCacheBase.php.

References $mUseGzip.

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

Member Data Documentation

◆ $mCached

bool null FileCacheBase::$mCached

protected

lazy loaded

Definition at line 52 of file FileCacheBase.php.

Referenced by isCached().

◆ $mExt

FileCacheBase::$mExt = 'cache'

protected

Definition at line 48 of file FileCacheBase.php.

◆ $mFilePath

FileCacheBase::$mFilePath

protected

Definition at line 49 of file FileCacheBase.php.

Referenced by cachePath().

◆ $mKey

FileCacheBase::$mKey

protected

Initial value:

=[,,,,,]
    private const CONSTRUCTOR_OPTIONS  
        MainConfigNames::CacheEpoch
        MainConfigNames::FileCacheDepth
        MainConfigNames::FileCacheDirectory
        MainConfigNames::MimeType
        MainConfigNames::UseGzip

Definition at line 46 of file FileCacheBase.php.

◆ $mType

FileCacheBase::$mType = 'object'

protected

Definition at line 47 of file FileCacheBase.php.

◆ $mUseGzip

FileCacheBase::$mUseGzip

protected

Definition at line 50 of file FileCacheBase.php.

Referenced by useGzip().

◆ $options

ServiceOptions FileCacheBase::$options

protected

Definition at line 54 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