MemcachedHandler
extends BaseHandler
in package
Mamcached cache handler
Tags
Table of Contents
Constants
- MAX_KEY_LENGTH = PHP_INT_MAX
- Maximum key length.
- RESERVED_CHARACTERS = '{}()/\@:'
- Reserved characters that cannot be used in a key or tag. May be overridden by the config.
Properties
- $config : array<string|int, mixed>
- Memcached Configuration
- $memcached : Memcache|Memcached
- The memcached object
- $prefix : string
- Prefix to apply to cache keys.
Methods
- __construct() : mixed
- Note: Use `CacheFactory::getHandler()` to instantiate.
- __destruct() : mixed
- Closes the connection to Memcache(d) if present.
- clean() : bool
- Will delete all items in the entire cache.
- decrement() : bool|int
- Performs atomic decrementation of a raw stored value.
- delete() : bool
- Deletes a specific item from the cache store.
- deleteMatching() : never
- Deletes items from the cache store matching a given pattern.
- get() : array<string|int, mixed>|bool|float|int|object|string|null
- Attempts to fetch an item from the cache store.
- getCacheInfo() : array<string|int, mixed>|false|object|null
- Returns information on the entire cache.
- getMetaData() : array<string|int, mixed>|false|null
- Returns detailed information about the specific item in the cache.
- increment() : bool|int
- Performs atomic incrementation of a raw stored value.
- initialize() : void
- Takes care of any handler-specific setup that must be done.
- isSupported() : bool
- Determines if the driver is supported on this system.
- remember() : array<string|int, mixed>|bool|float|int|object|string|null
- Get an item from the cache, or execute the given Closure and store the result.
- save() : bool
- Saves an item to the cache store.
- validateKey() : string
- Validates a cache key according to PSR-6.
Constants
MAX_KEY_LENGTH
Maximum key length.
public
mixed
MAX_KEY_LENGTH
= PHP_INT_MAX
RESERVED_CHARACTERS
Reserved characters that cannot be used in a key or tag. May be overridden by the config.
in favor of the Cache config
public
mixed
RESERVED_CHARACTERS
= '{}()/\@:'
From https://github.com/symfony/cache-contracts/blob/c0446463729b89dd4fa62e9aeecc80287323615d/ItemInterface.php#L43
Properties
$config
Memcached Configuration
protected
array<string|int, mixed>
$config
= ['host' => '127.0.0.1', 'port' => 11211, 'weight' => 1, 'raw' => false]
$memcached
The memcached object
protected
Memcache|Memcached
$memcached
$prefix
Prefix to apply to cache keys.
protected
string
$prefix
May not be used by all handlers.
Methods
__construct()
Note: Use `CacheFactory::getHandler()` to instantiate.
public
__construct(Cache $config) : mixed
Parameters
- $config : Cache
__destruct()
Closes the connection to Memcache(d) if present.
public
__destruct() : mixed
clean()
Will delete all items in the entire cache.
public
clean() : bool
Return values
bool —Success or failure
decrement()
Performs atomic decrementation of a raw stored value.
public
decrement(string $key[, int $offset = 1 ]) : bool|int
Parameters
- $key : string
-
Cache ID
- $offset : int = 1
-
Step/value to increase by
Return values
bool|intdelete()
Deletes a specific item from the cache store.
public
delete(string $key) : bool
Parameters
- $key : string
-
Cache item name
Return values
bool —Success or failure
deleteMatching()
Deletes items from the cache store matching a given pattern.
public
deleteMatching(string $pattern) : never
Parameters
- $pattern : string
-
Cache items glob-style pattern
Return values
neverget()
Attempts to fetch an item from the cache store.
public
get(string $key) : array<string|int, mixed>|bool|float|int|object|string|null
Parameters
- $key : string
-
Cache item name
Return values
array<string|int, mixed>|bool|float|int|object|string|nullgetCacheInfo()
Returns information on the entire cache.
public
getCacheInfo() : array<string|int, mixed>|false|object|null
Return values
array<string|int, mixed>|false|object|nullgetMetaData()
Returns detailed information about the specific item in the cache.
public
getMetaData(string $key) : array<string|int, mixed>|false|null
Parameters
- $key : string
-
Cache item name.
Return values
array<string|int, mixed>|false|null —Returns null if the item does not exist, otherwise array<string, mixed> with at least the 'expire' key for absolute epoch expiry (or null). Some handlers may return false when an item does not exist, which is deprecated.
increment()
Performs atomic incrementation of a raw stored value.
public
increment(string $key[, int $offset = 1 ]) : bool|int
Parameters
- $key : string
-
Cache ID
- $offset : int = 1
-
Step/value to increase by
Return values
bool|intinitialize()
Takes care of any handler-specific setup that must be done.
public
initialize() : void
isSupported()
Determines if the driver is supported on this system.
public
isSupported() : bool
Return values
boolremember()
Get an item from the cache, or execute the given Closure and store the result.
public
remember(string $key, int $ttl, callable(): mixed $callback) : array<string|int, mixed>|bool|float|int|object|string|null
Parameters
- $key : string
-
Cache item name
- $ttl : int
-
Time to live
- $callback : callable(): mixed
-
Callback return value
Return values
array<string|int, mixed>|bool|float|int|object|string|nullsave()
Saves an item to the cache store.
public
save(string $key, mixed $value[, int $ttl = 60 ]) : bool
Parameters
- $key : string
-
Cache item name
- $value : mixed
-
The data to save
- $ttl : int = 60
-
Time To Live, in seconds (default 60)
Return values
bool —Success or failure
validateKey()
Validates a cache key according to PSR-6.
public
static validateKey(string $key[, string $prefix = '' ]) : string
Keys that exceed MAX_KEY_LENGTH are hashed. From https://github.com/symfony/cache/blob/7b024c6726af21fd4984ac8d1eae2b9f3d90de88/CacheItem.php#L158
Parameters
- $key : string
-
The key to validate
- $prefix : string = ''
-
Optional prefix to include in length calculations