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: サーバーがアイテムを削除するまでの待ち時間。

注意: memcached 1.3.0 (2009年リリース) 以降は、この機能はサポートされなくなりました。ゼロでない time を渡すと、削除は失敗します。 Memcached::getResultCode() は MEMCACHED_INVALID_ARGUMENTS を返します。

成功した場合に true を、失敗した場合に false を返します。キーが存在しない場合、 Memcached::getResultCode() は Memcached::RES_NOTFOUND を返します。

There are no user contributed notes for this page.

Atelier ”慶”