Memcached::addByKey

(PECL memcached >= 0.1.0)

Memcached::addByKey — Add an item under a new key on a specific server

说明

public bool Memcached::addByKey ( string $server_key , string $key , mixed $value [, int $expiration ] )

Memcached::addByKey() is functionally equivalent to Memcached::add, except that the free-form server_key can be used to map the key to a specific server. This is useful if you need to keep a bunch of related keys on a certain server.

参数

server_key: The key identifying the server to store the value on.
key: The key under which to store the value.
value: The value to store.
expiration: The expiration time, defaults to 0. See Expiration Times for more info.

返回值

如果成功则返回 TRUE，失败则返回 FALSE。 The Memcached::getResultCode will return Memcached::RES_NOTSTORED if the key already exists.

参见

Memcached::add - Add an item under a new key
Memcached::set - Store an item
Memcached::replace - Replace the item under an existing key