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() - 複数のアイテムを要求する