指定したサーバーで複数のアイテムを格納する

# Memcached::setMultiByKey

(PECL memcached >= 0.1.0)

Memcached::setMultiByKey — 指定したサーバーで複数のアイテムを格納する

### 説明

public Memcached::setMultiByKey ( string `$server_key` , array `$items` [, int `$expiration` ] ) : bool

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

### パラメータ

`server_key`

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

`items`

  サーバーに格納する キー/値 のペアの配列。

`expiration`

  期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。

### 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。 必要に応じて Memcached::getResultCode() を使用しましょう。

### 参考

- Memcached::setMulti() - 複数のアイテムを格納する
- Memcached::set() - アイテムを格納する