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