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

Inherited by BagOStuff, MemcachedClient, and WANObjectCache.

Public Attributes
const	ATTR_DURABILITY = 2
	Durability of writes; see QOS_DURABILITY_* (higher means stronger)

const	ATTR_EMULATION = 1

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

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

Deprecated:: Since 1.41; 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

No storage medium error.

Definition at line 34 of file StorageAwareness.php.

Referenced by MemcachedClient\_incrdecr(), MemcachedClient\_set(), MemcachedClient\add(), MemcachedClient\decr(), MemcachedClient\delete(), MemcachedClient\get(), MemcachedClient\get_multi(), and MemcachedClient\touch().

◆ 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\getConnectionsForKeys().

◆ 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

Deprecated:: Since 1.41; 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:

includes/libs/objectcache/utils/StorageAwareness.php

Public Attributes