Memcached::delete
(PECL memcached >= 0.1.0)
Memcached::delete — 删除一个元素
说明
public bool Memcached::delete
( string $key
[, int $time
= 0
] )
Memcached::delete()从服务端删除key
对应的元素.
参数time
是一个秒为单位的时间(或一个UNIX时间戳表明直到那个时间), 用来表明
客户端希望服务端在这段时间拒绝对这个key的add和replace命令.
由于这个时间段的存在, 元素被放入一个删除队列, 表明它不可以通过get命令获取到值, 但是同时
add和replace命令也会失败(无论如何set命令都会成功).
在这段时间过去后, 元素最终被从服务端内存删除.time
参数默认0(表明元素会被立即删除并且之后对这个
key的存储命令也会成功).
参数
key
要删除的key
time
服务端等待删除该元素的总时间(或一个Unix时间戳表明的实际删除时间).
返回值
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
如果key不存在, Memcached::getResultCode()将会返回Memcached::RES_NOTFOUND
.
范例
Example #1 Memcached::delete() 示例
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->delete('key1');
?>
参见
Memcached::deleteByKey() - 从指定的服务器删除一个元素