Memcached::deleteByKey
(PECL memcached >= 0.1.0)
Memcached::deleteByKey — 从指定的服务器删除一个元素
说明
public Memcached::deleteByKey
( string
$server_key
, string $key
[, int $time
= 0
] ) : bool
Memcached::deleteByKey()除了可以通过server_key
参数自由的指定key
所映射的服务器外, 在功能上等同于Memcached::delete()。(译注: 关于*ByKey系列方法及$server_key的工作原理请参照addByKey方法文档)
参数
-
server_key
-
本键名用于识别储存和读取值的服务器。没有将实际的键名散列到具体的项目,而是在决定与哪一个 memcached 服务器通信时将其散列为服务器键名。这使得关联的项目在单一的服务上被组合起来以提高多重操作的效率。
-
key
-
要删除的key。
-
time
-
服务端等待删除该元素的总时间(或一个Unix时间戳表明的实际删除时间).
返回值
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
如果key不存在,Memcached::getResultCode()返回Memcached::RES_NOTFOUND
。