Memcached::deleteByKey
指定したサーバーからアイテムを削除する
説明
public bool Memcached::deleteByKey(string $server_key, string $key, int $time = 0)
パラメータ
-
server_key
-
値を格納したりデータを取得したりするサーバーを表すキー。
アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。
これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
-
key
-
削除したいキー。
-
time
-
サーバーがアイテムを削除するまでの待ち時間。
注意:
memcached 1.3.0 (2009年リリース) 以降は、
この機能はサポートされなくなりました。
ゼロでない time を渡すと、
削除は失敗します。
Memcached::getResultCode は
MEMCACHED_INVALID_ARGUMENTS
を返します。
戻り値
成功した場合に true を、失敗した場合に false を返します。
キーが存在しない場合、
Memcached::getResultCode は
Memcached::RES_NOTFOUND を返します。
参考
- Memcached::delete
- Memcached::deleteMulti
- Memcached::deleteMultiByKey