Memcached::deleteMulti
(PECL memcached >= 2.0.0)
Memcached::deleteMulti — 複数のアイテムを削除する
説明
public Memcached::deleteMulti
( array $keys
[, int $time
= 0
] ) : array
Memcached::deleteMulti() は、キーの配列
keys
をサーバーから削除します。
time
パラメータは、このキーによる
add
コマンドや
replace
コマンドをサーバーに拒否させたい秒数
(あるいはいつまで拒否するかを表す Unix タイム) を指定します。
この時間までの間、アイテムは削除キューに入れられます。つまり、
get
コマンドによる取得はできず、
add
コマンドや replace
コマンドでこのキーを指定した場合も失敗するということです
(set
コマンドは成功します)。
時間が経過したら、アイテムはサーバーのメモリ上から削除されます。
パラメータ time
のデフォルトは 0
(アイテムは即時に削除され、それ以降の格納コマンドが成功するようになる) です。
パラメータ
keys
- 削除したいキー。
time
- サーバーがアイテムを削除するまでの待ち時間。
返り値
配列を返します。
配列のインデックスが keys
で指定され、
その値は削除操作が成功したかどうかを示します。
キーが存在しない場合、
Memcached::getResultCode() は
Memcached::RES_NOTFOUND
を返します。
参考
- Memcached::delete() - アイテムを削除する
- Memcached::deleteByKey() - 指定したサーバーからアイテムを削除する
- Memcached::deleteMultiByKey() - 指定したサーバーから複数のアイテムを削除する