Memcached::prependByKey

(PECL memcached >= 0.1.0)

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

public function Memcached::prependByKey(string $server_key, string $key, string $value): ?bool

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

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

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

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

関連キーワード: