指定したサーバーから複数のアイテムを取得する

# Memcached::getMultiByKey

(PECL memcached >= 0.1.0)

Memcached::getMultiByKey — 指定したサーバーから複数のアイテムを取得する

### 説明

public Memcached::getMultiByKey ( string `$server_key` , array `$keys` [, int `$flags` ] ) : array

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

### パラメータ

`server_key`

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

`keys`

  取得したいキーの配列。

`flags`

  取得操作のフラグ。

### 返り値

見つかったアイテムの配列、失敗した場合に `FALSE` を返します。 必要に応じて Memcached::getResultCode() を使用しましょう。

### 変更履歴

バージョン | 説明
--- | ---
3.0.0 | `&cas_tokens` パラメータは削除されました。 The `Memcached::GET_EXTENDED` was added and when passed as a flag it ensures the CAS tokens to be fetched.

### 参考

- Memcached::getMulti() - 複数のアイテムを取得する
- Memcached::get() - アイテムを取得する
- Memcached::getDelayed() - 複数のアイテムを要求する