Memcached::replaceByKey

(PECL memcached >= 0.1.0)

Memcached::replaceByKey — 指定したサーバーで既存のキーのアイテムを入れ替える

説明

public function Memcached::replaceByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = 0
): bool

Memcached::replaceByKey() は機能的に Memcached::replace() と同等です。しかし、自由形式の server_key を使用して、 key を特定のサーバーに関連付けることができます。これは、関連するキーを特定のサーバーに置き続けたいときなどに便利です。

パラメータ

server_key: 値を格納したりデータを取得したりするサーバーを表すキー。アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
key: 値の格納先のキー。
value: 格納する値。
expiration: 期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限を参照ください。

戻り値

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

参考

Memcached::replace() - 既存のキーのアイテムを入れ替える
Memcached::set() - アイテムを格納する
Memcached::add() - アイテムを新しいキーで追加する

関連キーワード:

Memcached キーサーバーアイテム既存 replaceByKey replace server 関連格納 memcached expiration 特定ハッシュ resetServerList mixed 機能的自由便利実際マルチ操作効率格納先期限切れ