Php/docs/memcached.replacebykey

• PHP Manual
• Memcached
• Replace the item under an existing key on a specific server

Memcached::replaceByKey

(PECL memcached >= 0.1.0)

Memcached::replaceByKey — Replace the item under an existing key on a specific server

说明

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

除了可以使用server_key自由的将key映射到指定服务器外， Memcached::replaceByKey()在功能上等同于Memcached::replace()。 (译注: 关于*ByKey系列方法及$server_key的工作原理请参照addByKey方法文档)。

参数

server_key

本键名用于识别储存和读取值的服务器。没有将实际的键名散列到具体的项目，而是在决定与哪一个 memcached 服务器通信时将其散列为服务器键名。这使得关联的项目在单一的服务上被组合起来以提高多重操作的效率。

key

用于存储值的键名。

value

存储的值。

expiration

到期时间，默认为 0。 更多信息请参见到期时间。

返回值

成功时返回 true， 或者在失败时返回 false。 如果key不存在，Memcached::getResultCode()返回Memcached::RES_NOTSTORED。

参见

• Memcached::replace() - 替换已存在key下的元素
• Memcached::set() - 存储一个元素
• Memcached::add() - 向一个新的key下面增加一个元素