Memcached::deleteByKey
(PECL memcached >= 0.1.0)
Memcached::deleteByKey — 指定したサーバーからアイテムを削除する
説明
public Memcached::deleteByKey
( string
$server_key
, string $key
[, int $time = 0
] ) : bool
Memcached::deleteByKey() は機能的に
Memcached::delete() と同等です。しかし、自由形式の
server_key を使用して、
key を特定のサーバーに関連付けることができます。
パラメータ
-
server_key -
値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
-
key -
削除したいキー。
-
time -
サーバーがアイテムを削除するまでの待ち時間。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
キーが存在しない場合、
Memcached::getResultCode() は
Memcached::RES_NOTFOUND を返します。
参考
- Memcached::delete() - アイテムを削除する
- Memcached::deleteMulti() - 複数のアイテムを削除する
- Memcached::deleteMultiByKey() - 指定したサーバーから複数のアイテムを削除する