1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
|
<?php
/**
* Functions to get cache objects
*
* @file
* @ingroup Cache
*/
class ObjectCache {
static $instances = array();
/**
* Get a cached instance of the specified type of cache object.
*
* @param $id
*
* @return object
*/
static function getInstance( $id ) {
if ( isset( self::$instances[$id] ) ) {
return self::$instances[$id];
}
$object = self::newFromId( $id );
self::$instances[$id] = $object;
return $object;
}
/**
* Clear all the cached instances.
*/
static function clear() {
self::$instances = array();
}
/**
* Create a new cache object of the specified type.
*
* @param $id
*
* @return ObjectCache
*/
static function newFromId( $id ) {
global $wgObjectCaches;
if ( !isset( $wgObjectCaches[$id] ) ) {
throw new MWException( "Invalid object cache type \"$id\" requested. " .
"It is not present in \$wgObjectCaches." );
}
return self::newFromParams( $wgObjectCaches[$id] );
}
/**
* Create a new cache object from parameters
*
* @param $params array
*
* @return ObjectCache
*/
static function newFromParams( $params ) {
if ( isset( $params['factory'] ) ) {
return call_user_func( $params['factory'], $params );
} elseif ( isset( $params['class'] ) ) {
$class = $params['class'];
return new $class( $params );
} else {
throw new MWException( "The definition of cache type \"" . print_r( $params, true ) . "\" lacks both " .
"factory and class parameters." );
}
}
/**
* Factory function referenced from DefaultSettings.php for CACHE_ANYTHING
*/
static function newAnything( $params ) {
global $wgMainCacheType, $wgMessageCacheType, $wgParserCacheType;
$candidates = array( $wgMainCacheType, $wgMessageCacheType, $wgParserCacheType );
foreach ( $candidates as $candidate ) {
if ( $candidate !== CACHE_NONE && $candidate !== CACHE_ANYTHING ) {
return self::getInstance( $candidate );
}
}
return self::getInstance( CACHE_DB );
}
/**
* Factory function referenced from DefaultSettings.php for CACHE_ACCEL.
*
* @return ObjectCache
*/
static function newAccelerator( $params ) {
if ( function_exists( 'apc_fetch') ) {
$id = 'apc';
} elseif( function_exists( 'xcache_get' ) && wfIniGetBool( 'xcache.var_size' ) ) {
$id = 'xcache';
} elseif( function_exists( 'wincache_ucache_get' ) ) {
$id = 'wincache';
} else {
throw new MWException( "CACHE_ACCEL requested but no suitable object " .
"cache is present. You may want to install APC." );
}
return self::newFromId( $id );
}
/**
* Factory function that creates a memcached client object.
* The idea of this is that it might eventually detect and automatically
* support the PECL extension, assuming someone can get it to compile.
*
* @param $params array
*
* @return MemcachedPhpBagOStuff
*/
static function newMemcached( $params ) {
return new MemcachedPhpBagOStuff( $params );
}
}
|