Memcached::prependByKey

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

説明

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

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

パラメータ

server_key

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

key

データを先頭に付加したいアイテムのキー。

value

先頭に付加する文字列。

戻り値

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

エラー / 例外

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

参考

  • Memcached::prepend
  • Memcached::append