Memcached::setByKey

(PECL memcached >= 0.1.0)

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

说明

public bool Memcached::setByKey ( 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: 此键名标识存储值的服务器。
key: 用于存储值的键名。
value: 存储的值
expiration: 到期时间，默认为 0。更多信息请参见到期时间。

返回值

成功时返回 TRUE，或者在失败时返回 FALSE. 如需要则使用 Memcached::getResultCode()。

范例

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