MediaWiki REL1_40
Wikimedia\LightweightObjectStore\StorageAwareness Interface Reference

Generic interface providing error code and quality-of-service constants for object stores. More...

Inherited by BagOStuff, IExpiringStore, MemcachedClient, and WANObjectCache.

Public Attributes

const ATTR_DURABILITY = 2
 Durability of writes; see QOS_DURABILITY_* (higher means stronger)
 
const ATTR_EMULATION = 1
 Emulation/fallback mode; see QOS_EMULATION_*; higher is better.
 
const ERR_NO_RESPONSE = 1
 Storage medium failed to yield a complete response to an operation.
 
const ERR_NONE = 0
 No storage medium error.
 
const ERR_UNEXPECTED = 3
 Storage medium operation failed due to usage limitations or an I/O error.
 
const ERR_UNREACHABLE = 2
 Storage medium could not be reached to establish a connection.
 
const QOS_DURABILITY_DISK = 4
 Data is saved to disk and writes do not usually block on fsync()
 
const QOS_DURABILITY_NONE = 1
 Data is never saved to begin with (blackhole store)
 
const QOS_DURABILITY_RDBMS = 5
 Data is saved to disk and writes usually block on fsync(), like a standard RDBMS.
 
const QOS_DURABILITY_SCRIPT = 2
 Data is lost at the end of the current web request or CLI script.
 
const QOS_DURABILITY_SERVICE = 3
 Data is lost once the service storing the data restarts.
 
const QOS_EMULATION_SQL = 1
 Fallback disk-based SQL store.
 
const QOS_UNKNOWN = INF
 Generic "unknown" value; useful for comparisons (always "good enough")
 

Detailed Description

Generic interface providing error code and quality-of-service constants for object stores.

Since
1.35

Definition at line 32 of file StorageAwareness.php.

Member Data Documentation

◆ ATTR_DURABILITY

const Wikimedia\LightweightObjectStore\StorageAwareness::ATTR_DURABILITY = 2

Durability of writes; see QOS_DURABILITY_* (higher means stronger)

Definition at line 45 of file StorageAwareness.php.

Referenced by RedisBagOStuff\__construct(), RESTBagOStuff\__construct(), and MemcachedBagOStuff\__construct().

◆ ATTR_EMULATION

const Wikimedia\LightweightObjectStore\StorageAwareness::ATTR_EMULATION = 1

Emulation/fallback mode; see QOS_EMULATION_*; higher is better.

Definition at line 43 of file StorageAwareness.php.

◆ ERR_NO_RESPONSE

const Wikimedia\LightweightObjectStore\StorageAwareness::ERR_NO_RESPONSE = 1

Storage medium failed to yield a complete response to an operation.

Definition at line 36 of file StorageAwareness.php.

Referenced by MemcachedClient\_incrdecr(), MemcachedClient\_set(), MemcachedClient\get(), and MemcachedClient\get_multi().

◆ ERR_NONE

const Wikimedia\LightweightObjectStore\StorageAwareness::ERR_NONE = 0

◆ ERR_UNEXPECTED

const Wikimedia\LightweightObjectStore\StorageAwareness::ERR_UNEXPECTED = 3

Storage medium operation failed due to usage limitations or an I/O error.

Definition at line 40 of file StorageAwareness.php.

Referenced by MemcachedClient\_incrdecr(), MemcachedClient\_set(), MemcachedClient\delete(), MemcachedClient\get(), MemcachedClient\get_multi(), RESTBagOStuff\handleError(), and RedisBagOStuff\handleException().

◆ ERR_UNREACHABLE

const Wikimedia\LightweightObjectStore\StorageAwareness::ERR_UNREACHABLE = 2

Storage medium could not be reached to establish a connection.

Definition at line 38 of file StorageAwareness.php.

Referenced by MemcachedClient\_incrdecr(), MemcachedClient\_set(), MemcachedClient\get(), MemcachedClient\get_multi(), and RedisBagOStuff\getConnection().

◆ QOS_DURABILITY_DISK

const Wikimedia\LightweightObjectStore\StorageAwareness::QOS_DURABILITY_DISK = 4

Data is saved to disk and writes do not usually block on fsync()

Definition at line 57 of file StorageAwareness.php.

Referenced by RedisBagOStuff\__construct(), and RESTBagOStuff\__construct().

◆ QOS_DURABILITY_NONE

const Wikimedia\LightweightObjectStore\StorageAwareness::QOS_DURABILITY_NONE = 1

Data is never saved to begin with (blackhole store)

Definition at line 51 of file StorageAwareness.php.

◆ QOS_DURABILITY_RDBMS

const Wikimedia\LightweightObjectStore\StorageAwareness::QOS_DURABILITY_RDBMS = 5

Data is saved to disk and writes usually block on fsync(), like a standard RDBMS.

Definition at line 59 of file StorageAwareness.php.

◆ QOS_DURABILITY_SCRIPT

const Wikimedia\LightweightObjectStore\StorageAwareness::QOS_DURABILITY_SCRIPT = 2

Data is lost at the end of the current web request or CLI script.

Definition at line 53 of file StorageAwareness.php.

◆ QOS_DURABILITY_SERVICE

const Wikimedia\LightweightObjectStore\StorageAwareness::QOS_DURABILITY_SERVICE = 3

Data is lost once the service storing the data restarts.

Definition at line 55 of file StorageAwareness.php.

Referenced by MemcachedBagOStuff\__construct().

◆ QOS_EMULATION_SQL

const Wikimedia\LightweightObjectStore\StorageAwareness::QOS_EMULATION_SQL = 1

Fallback disk-based SQL store.

Definition at line 48 of file StorageAwareness.php.

◆ QOS_UNKNOWN

const Wikimedia\LightweightObjectStore\StorageAwareness::QOS_UNKNOWN = INF

Generic "unknown" value; useful for comparisons (always "good enough")

Definition at line 62 of file StorageAwareness.php.


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