Memcached::appendByKey
(PECL memcached >= 0.1.0)
Memcached::appendByKey — 指定したサーバーでデータを既存のアイテムに追記する
説明
public Memcached::appendByKey
( string $server_key
, string $key
, string $value
) : bool
Memcached::appendByKey() は機能的に
Memcached::append() と同等です。しかし、自由形式の
server_key
を使用して、
key
を特定のサーバーに関連付けることができます。
パラメータ
server_key
- 値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
key
- 値の格納先のキー。
value
- 追記する文字列。
返り値
成功した場合に true
を、失敗した場合に false
を返します。
Memcached::getResultCode() は、キーが存在しない場合に
Memcached::RES_NOTSTORED
を返します。