Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKey — Store an item on a specific server

说明

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

Memcached::setByKey() is functionally equivalent to Memcached::set, 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。 Use Memcached::getResultCode if necessary.

范例

Example #1 Memcached::setByKey() example


<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

/* keep IP blocks on a certain server */
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>

参见

Memcached::set - Store an item