Memcached::getMultiByKey

(PECL memcached >= 0.1.0)

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

public Memcached::getMultiByKey(string $server_key, array $keys, int $flags = ?): array|false

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

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

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

バージョン	説明
PECL memcached 3.0.0	`&cas_tokens` パラメータは削除されました。また、`Memcached::GET_EXTENDED` が追加され、それがフラグとして渡された時にCASトークンを取得することを保証するようになりました。