EtcdConfig Class Reference

Interface for configuration instances. More...

Inheritance diagram for EtcdConfig:

Collaboration diagram for EtcdConfig:

Public Member Functions
	__construct (array $params)
	fetchAllFromEtcd ()
	get ( $name)
	Get a configuration variable such as "Sitename" or "UploadMaintenance.".
	getModifiedIndex ()
	has ( $name)
	Check whether a configuration option is set for the given name.
	setLogger (LoggerInterface $logger)

Protected Member Functions
	fetchAllFromEtcdServer ( $address)
	parseDirectory ( $dirName, $dirNode, &$config)
	Recursively parse a directory node and populate the array passed by reference, throwing EtcdConfigParseError if there is a validation error.
	parseResponse ( $rbody)
	Parse a response body, throwing EtcdConfigParseError if there is a validation error.

Private Member Functions
	load ()
	unserialize ( $string)

Private Attributes
int	$baseCacheTTL
string	$directory
string	$encoding
string	$host
MultiHttpClient	$http
LoggerInterface	$logger
array	$procCache
string	$protocol
int	$skewCacheTTL
BagOStuff	$srvCache
int	$timeout

Detailed Description

Interface for configuration instances.

Since

1.29

Definition at line 31 of file EtcdConfig.php.

Constructor & Destructor Documentation

__construct()

EtcdConfig::__construct

(

array

$params

)

Parameters

array

$params

Parameter map: host: the host address and port protocol: either http or https directory: the etc "directory" were MediaWiki specific variables are located encoding: one of ("JSON", "YAML"). Defaults to JSON. [optional] cache: BagOStuff instance or ObjectFactory spec thereof for a server cache. The cache will also be used as a fallback if etcd is down. [optional] cacheTTL: logical cache TTL in seconds [optional] skewTTL: maximum seconds to randomly lower the assigned TTL on cache save [optional] timeout: seconds to wait for etcd before throwing an error [optional]

Definition at line 68 of file EtcdConfig.php.

References $params, directory, and http.

Member Function Documentation

fetchAllFromEtcd()

EtcdConfig::fetchAllFromEtcd

(

)

Returns

array (containing the keys config, error, retry, modifiedIndex)

Definition at line 209 of file EtcdConfig.php.

References $response.

fetchAllFromEtcdServer()

EtcdConfig::fetchAllFromEtcdServer (   $address )

protected

Parameters

string

$address

Host and port

Returns

array (containing the keys config, error, retry, modifiedIndex)

Definition at line 238 of file EtcdConfig.php.

References $e, $response, http, list, and true.

get()

EtcdConfig::get

(

$name

)

Get a configuration variable such as "Sitename" or "UploadMaintenance.".

Parameters

string

$name

Name of configuration option

Returns

mixed Value configured

Exceptions

ConfigException

Implements Config.

Definition at line 112 of file EtcdConfig.php.

References $name, and load().

getModifiedIndex()

EtcdConfig::getModifiedIndex

(

)

Definition at line 122 of file EtcdConfig.php.

References load().

has()

EtcdConfig::has

(

$name

)

Check whether a configuration option is set for the given name.

Parameters

string

$name

Name of configuration option

Returns

bool

Since

1.24

Implements Config.

Definition at line 106 of file EtcdConfig.php.

References $name, and load().

load()

EtcdConfig::load ( )

private

Exceptions

ConfigException

Definition at line 130 of file EtcdConfig.php.

References directory, and use.

Referenced by get(), getModifiedIndex(), and has().

parseDirectory()

EtcdConfig::parseDirectory (   $dirName,   $dirNode, &  $config  )

protected

Recursively parse a directory node and populate the array passed by reference, throwing EtcdConfigParseError if there is a validation error.

Parameters

string	$dirName	The relative directory name
array	$dirNode	The decoded directory node
array	&$config	The output array

Returns

int lastModifiedIndex The maximum last modified index across all keys in the directory

Definition at line 292 of file EtcdConfig.php.

References $fullName, $value, as, and unserialize().

parseResponse()

EtcdConfig::parseResponse (   $rbody )

protected

Parse a response body, throwing EtcdConfigParseError if there is a validation error.

Parameters

string

$rbody

Returns

array

Definition at line 269 of file EtcdConfig.php.

setLogger()

EtcdConfig::setLogger

(

LoggerInterface

$logger

)

Definition at line 101 of file EtcdConfig.php.

References $logger, and http.

unserialize()

EtcdConfig::unserialize (   $string )

private

Parameters

string

$string

Returns

mixed

Definition at line 326 of file EtcdConfig.php.

Member Data Documentation

$baseCacheTTL

int EtcdConfig::$baseCacheTTL

private

Definition at line 50 of file EtcdConfig.php.

$directory

string EtcdConfig::$directory

private

Definition at line 46 of file EtcdConfig.php.

$encoding

string EtcdConfig::$encoding

private

Definition at line 48 of file EtcdConfig.php.

$host

string EtcdConfig::$host

private

Definition at line 42 of file EtcdConfig.php.

$http

MultiHttpClient EtcdConfig::$http

private

Definition at line 33 of file EtcdConfig.php.

$logger

LoggerInterface EtcdConfig::$logger

private

Definition at line 39 of file EtcdConfig.php.

Referenced by setLogger().

$procCache

array EtcdConfig::$procCache

private

Definition at line 37 of file EtcdConfig.php.

$protocol

string EtcdConfig::$protocol

private

Definition at line 44 of file EtcdConfig.php.

$skewCacheTTL

int EtcdConfig::$skewCacheTTL

private

Definition at line 52 of file EtcdConfig.php.

$srvCache

BagOStuff EtcdConfig::$srvCache

private

Definition at line 35 of file EtcdConfig.php.

$timeout

int EtcdConfig::$timeout

private

Definition at line 54 of file EtcdConfig.php.

---

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

• includes/config/EtcdConfig.php