array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'memcached.getmultibykey.php', 1 => 'Memcached::getMultiByKey', 2 => '指定したサーバーから複数のアイテムを取得する', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.getmulti.php', 1 => 'Memcached::getMulti', ), 'next' => array ( 0 => 'memcached.getoption.php', 1 => 'Memcached::getOption', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/memcached/memcached/getmultibykey.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcached::getMultiByKey

(PECL memcached >= 0.1.0)

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

説明

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

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

パラメータ

server_key

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

keys

取得したいキーの配列。

get_flags

取得操作のフラグ。

戻り値

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

変更履歴

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

参考