Memcached::replaceByKey

(PECL memcached >= 0.1.0)

Memcached::replaceByKey在指定服务器上,替换已存在 key 下的元素

说明

public Memcached::replaceByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = 0
): 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

参见