(PECL memcached >= 0.1.0)
Memcached::replaceByKey — 指定したサーバーで既存のキーのアイテムを入れ替える
$server_key
, string $key
, mixed $value
[, int $expiration
] )
Memcached::replaceByKey() は機能的に
Memcached::replace() と同等です。しかし、自由形式の
server_key を使用して、
key を特定のサーバーに関連付けることができます。
これは、関連するキーを特定のサーバーに置き続けたいときなどに便利です。
server_key値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
key値の格納先のキー。
value格納する値。
expiration期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。
成功した場合に TRUE を、失敗した場合に FALSE を返します。
キーが存在しない場合、
Memcached::getResultCode() は
Memcached::RES_NOTSTORED を返します。