Memcached::appendByKey

指定したサーバーでデータを既存のアイテムに追記する

説明

public boolnull Memcached::appendByKey(string $server_key, string $key, string $value)

Memcached::appendByKey は機能的に Memcached::append と同等です。しかし、自由形式の server_key を使用して、 key を特定のサーバーに関連付けることができます。

パラメータ

server_key

値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。

key

値の格納先のキー。

value

追記する文字列。

戻り値

成功した場合に true を、失敗した場合に false を返します。 圧縮が有効になっている場合は null を返します。

エラー / 例外

圧縮が有効になっている場合は null を返し、 E_WARNING が発生します。

参考

  • Memcached::append
  • Memcached::prepend