(PECL memcached >= 0.1.0)
Memcached::deleteByKey — 指定したサーバーからアイテムを削除する
Memcached::deleteByKey() は機能的に
Memcached::delete() と同等です。しかし、自由形式の
server_key
を使用して、
key
を特定のサーバーに関連付けることができます。
server_key
値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
key
削除したいキー。
time
サーバーがアイテムを削除するまでの待ち時間。
注意: memcached 1.3.0 (2009年リリース) 以降は、 この機能はサポートされなくなりました。 ゼロでない
time
を渡すと、 削除は失敗します。 Memcached::getResultCode() はMEMCACHED_INVALID_ARGUMENTS
を返します。
成功した場合に true
を、失敗した場合に false
を返します。
キーが存在しない場合、
Memcached::getResultCode() は
Memcached::RES_NOTFOUND
を返します。