Class MemcacheEngine

Memcache storage engine for cache. Memcache has some limitations in the amount of control you have over expire times far in the future. See MemcacheEngine::write() for more information.

CacheEngine

MemcacheEngine

Package: Cake\Cache\Engine
Deprecated: 3.0.0 You should use the Memcached adapter instead.
Copyright: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
License: MIT License
Location: Cake/Cache/Engine/MemcacheEngine.php

Properties summary

$_Memcache protected

Memcache

Memcache wrapper.
$_compiledGroupNames protected

array

Contains the compiled group names (prefixed with the global configuration prefix)
$settings public

array

Settings

Inherited Properties

_groupPrefix

Method Summary

_parseServerString() protected deprecated

Parses the server address into the host/port. Handles both IPv6 and IPv4 addresses and Unix sockets
add() public deprecated

Write data for key into cache if it doesn't exist already. When using memcached as your cache engine remember that the Memcached PECL extension does not support cache expiry times greater than 30 days in the future. Any duration greater than 30 days will be treated as never expiring. If it already exists, it fails and returns false.
clear() public deprecated

Delete all keys from the cache
clearGroup() public deprecated

Increments the group value to simulate deletion of all keys under a group old values will remain in storage until they expire.
connect() public deprecated

Connects to a server in connection pool
decrement() public deprecated

Decrements the value of an integer cached key
delete() public deprecated

Delete a key from the cache
groups() public deprecated

Returns the group value for each of the configured groups If the group initial value was not found, then it initializes the group accordingly.
increment() public deprecated

Increments the value of an integer cached key
init() public deprecated

Initialize the Cache Engine
read() public deprecated

Read a key from the cache
write() public deprecated

Write data for key into cache. When using memcache as your cache engine remember that the Memcache pecl extension does not support cache expiry times greater than 30 days in the future. Any duration greater than 30 days will be treated as never expiring.

Method Detail

_parseServerString() protected deprecated ¶

_parseServerString( string $server )

Parses the server address into the host/port. Handles both IPv6 and IPv4 addresses and Unix sockets

Parameters

string $server: The server address string.

Returns

array
Array containing host, port

add() public deprecated ¶

add( string $key , mixed $value , integer $duration )

Write data for key into cache if it doesn't exist already. When using memcached as your cache engine remember that the Memcached PECL extension does not support cache expiry times greater than 30 days in the future. Any duration greater than 30 days will be treated as never expiring. If it already exists, it fails and returns false.

Parameters

string $key: Identifier for the data.
mixed $value: Data to be cached.
integer $duration: How long to cache the data, in seconds.

Returns

boolean
True if the data was successfully cached, false on failure.

Link

http://php.net/manual/en/memcache.add.php

Overrides

CacheEngine::add()

clear() public deprecated ¶

clear( boolean $check )

Delete all keys from the cache

Parameters

boolean $check: If true no deletes will occur and instead CakePHP will rely on key TTL values.

Returns

boolean
True if the cache was successfully cleared, false otherwise

clearGroup() public deprecated ¶

clearGroup( string $group )

Increments the group value to simulate deletion of all keys under a group old values will remain in storage until they expire.

Parameters

string $group: The group to clear.

Returns

boolean
success

Overrides

CacheEngine::clearGroup()

connect() public deprecated ¶

connect( string $host , integer $port = 11211 )

Connects to a server in connection pool

Parameters

string $host: host ip address or name
integer $port optional 11211: Server port

Returns

boolean
True if memcache server was connected

decrement() public deprecated ¶

decrement( string $key , integer $offset = 1 )

Decrements the value of an integer cached key

Parameters

string $key: Identifier for the data
integer $offset optional 1: How much to subtract

Returns

New
decremented value, false otherwise

Throws

CacheException
when you try to decrement with compress = true

delete() public deprecated ¶

delete( string $key )

Delete a key from the cache

Parameters

string $key: Identifier for the data

Returns

boolean
True if the value was successfully deleted, false if it didn't exist or couldn't be removed

groups() public deprecated ¶

groups( )

Returns the group value for each of the configured groups If the group initial value was not found, then it initializes the group accordingly.

Returns

array

Overrides

CacheEngine::groups()

increment() public deprecated ¶

increment( string $key , integer $offset = 1 )

Increments the value of an integer cached key

Parameters

string $key: Identifier for the data
integer $offset optional 1: How much to increment

Returns

New
incremented value, false otherwise

Throws

CacheException
when you try to increment with compress = true

init() public deprecated ¶

init( array $settings = array() )

Initialize the Cache Engine

Called automatically by the cache frontend To reinitialize the settings call Cache::engine('EngineName', [optional] settings = array());

Parameters

array $settings optional array(): array of setting for the engine

Returns

boolean
True if the engine has been successfully initialized, false if not

Overrides

CacheEngine::init()

read() public deprecated ¶

read( string $key )

Read a key from the cache

Parameters

string $key: Identifier for the data

Returns

mixed
The cached data, or false if the data doesn't exist, has expired, or if there was an error fetching it

write() public deprecated ¶

write( string $key , mixed $value , integer $duration )

Write data for key into cache. When using memcache as your cache engine remember that the Memcache pecl extension does not support cache expiry times greater than 30 days in the future. Any duration greater than 30 days will be treated as never expiring.

Parameters

string $key: Identifier for the data
mixed $value: Data to be cached
integer $duration: How long to cache the data, in seconds

Returns

boolean
True if the data was successfully cached, false on failure

See

http://php.net/manual/en/memcache.set.php

Methods inherited from CacheEngine

gc() public ¶

gc( integer $expires = null )

Garbage collection

Permanently remove all expired and deleted data

Parameters

integer $expires optional null: [optional] An expires timestamp, invalidating all data before.

key() public ¶

key( string $key )

Generates a safe key for use with cache engine storage engines.

Parameters

string $key: the key passed over

Returns

mixed
string $key or false

settings() public ¶

settings( )

Cache Engine settings

Returns

array
settings

Properties detail

`$_Memcache` ¶

protected Memcache

Memcache wrapper.

null

`$_compiledGroupNames` ¶

protected array

Contains the compiled group names (prefixed with the global configuration prefix)

array()

`$settings` ¶

public array

Settings

servers = string or array of memcache servers, default => 127.0.0.1. If an array MemcacheEngine will use them as a pool.
- compress = boolean, default => false

array()

Packages

Classes

Class MemcacheEngine

Properties summary

Inherited Properties

Method Summary

_parseServerString() protected deprecated

add() public deprecated

clear() public deprecated

clearGroup() public deprecated

connect() public deprecated

decrement() public deprecated

delete() public deprecated

groups() public deprecated

increment() public deprecated

init() public deprecated

read() public deprecated

write() public deprecated

Method Detail

_parseServerString() protected deprecated ¶

Parameters

Returns

add() public deprecated ¶

Parameters

Returns

Link

Overrides

clear() public deprecated ¶

Parameters

Returns

clearGroup() public deprecated ¶

Parameters

Returns

Overrides

connect() public deprecated ¶

Parameters

Returns

decrement() public deprecated ¶

Parameters

Returns

Throws

delete() public deprecated ¶

Parameters

Returns

groups() public deprecated ¶

Returns

Overrides

increment() public deprecated ¶

Parameters

Returns

Throws

init() public deprecated ¶

Parameters

Returns

Overrides

read() public deprecated ¶

Parameters

Returns

write() public deprecated ¶

Parameters

Returns

See

Methods inherited from CacheEngine

gc() public ¶

Parameters

key() public ¶

Parameters

Returns

settings() public ¶

Returns

Properties detail

$_Memcache ¶

$_compiledGroupNames ¶

$settings ¶

`$_Memcache` ¶

`$_compiledGroupNames` ¶

`$settings` ¶