(PECL memcached >= 0.1.0)
Memcached::getMulti — 複数のアイテムを取得する
Memcached::getMulti() は Memcached::get と似ていますが、ひとつのキーのアイテムを取得するのではなく keys 配列で指定したキー群から複数のアイテムを取得します。 cas_tokens 変数を指定した場合は、取得したアイテムの CAS トークンの値をそこに格納します。
注意: Memcached::get とは異なり、 Memcached::getMulti() では read-through キャッシュコールバックを指定することができません。 memcache プロトコルでは、複数キーのリクエストでどのキーが見つからなかったのかを知る手段がないからです。
取得したいキーの配列。
見つかったアイテムの CAS トークンを格納する変数。
見つかったアイテムの配列、あるいは失敗した場合に FALSE を返します。 必要に応じて Memcached::getResultCode を使用しましょう。
例1 Memcached::getMulti() の例
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$items = array(
'key1' => 'value1',
'key2' => 'value2',
'key3' => 'value3'
);
$m->setMulti($items);
$result = $m->getMulti(array('key1', 'key3', 'badkey'), $cas);
var_dump($result, $cas);
?>
上の例の出力は、たとえば 以下のようになります。
array(2) {
["key1"]=>
string(6) "value1"
["key3"]=>
string(6) "value3"
}
array(2) {
["key1"]=>
float(2360)
["key3"]=>
float(2362)
}