(PECL memcached >= 0.1.0)
Memcached::delete — アイテムを削除する
$key
, int $time
= 0): bool
Memcached::delete() は、キー
key
をサーバーから削除します。
time
パラメータは、このキーによる
add
コマンドや
replace
コマンドをサーバーに拒否させたい秒数
(あるいはいつまで拒否するかを表す Unix タイム) を指定します。
この時間までの間、アイテムは削除キューに入れられます。つまり、
get
コマンドによる取得はできず、
add
コマンドや replace
コマンドでこのキーを指定した場合も失敗するということです
(set
コマンドは成功します)。
時間が経過したら、アイテムはサーバーのメモリ上から削除されます。
パラメータ time
のデフォルトは 0
(アイテムは即時に削除され、それ以降の格納コマンドが成功するようになる) です。
key
削除したいキー。
time
サーバーがアイテムを削除するまでの待ち時間。
成功した場合に true
を、失敗した場合に false
を返します。
キーが存在しない場合、
Memcached::getResultCode() は
Memcached::RES_NOTFOUND
を返します。
例1 Memcached::delete() の例
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->delete('key1');
?>