PHP マニュアル: 指定したサーバーで複数のアイテムを格納する

説明

public bool Memcached::setMultiByKey(string $server_key, array $items, int $expiration = 0)

Memcached::setMultiByKey は機能的に Memcached::setMulti と同等です。しかし、自由形式の server_key を使用して、 key を特定のサーバーに関連付けることができます。これは、関連するキーを特定のサーバーに置き続けたいときなどに便利です。

パラメータ

server_key: 値を格納したりデータを取得したりするサーバーを表すキー。アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
items: サーバーに格納するキー/値のペアの配列。
expiration: 期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限を参照ください。

戻り値

成功した場合に true を、失敗した場合に false を返します。必要に応じて Memcached::getResultCode を使用しましょう。

参考

Memcached::setMulti
Memcached::set