(PECL memcached >= 0.1.0)
Memcached::getMulti — Получает несколько записей
Memcached::getMulti() работает аналогично методу
Memcached::get(), но вместо одной записи
получает несколько, ключи которых были переданы в массиве
keys.
Замечание:
До версии 3.0 использовался второй аргумент
&cas_tokens. Он заполнялся значениями токена CAS для найденных записей. Параметр&cas_tokensбыл удалён в версии 3.0. Он был заменён новым флагомMemcached::GET_EXTENDED, который указывается в параметреget_flags.
Параметр get_flags может использоваться для указания дополнительных
настроек для метода Memcached::getMulti(). На данный момент
поддерживаются, только следующие настройки:
Memcached::GET_PRESERVE_ORDER гарантирует что записи будут
возвращены в том же порядке, что и были запрошены.
Memcached::GET_EXTENDED ведёт к тому, что также будут
извлечены токены CAS.
keysМассив ключей для запроса.
get_flagsФлаги для операции получения записей.
Возвращает массив найденных записей или false, если возникла ошибка.
Вызывайте метод
Memcached::getResultCode(), если требуется.
| Версия | Описание |
|---|---|
| PECL memcached 3.0.0 |
Удалён параметр &cas_tokens.
Добавлена константа Memcached::GET_EXTENDED для
возврата токенов CAS.
|
Пример #1 Пример использования Memcached::getMulti() версии 3
<?php
// Работает с версией модуля 3
$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'));
var_dump($result);
?>Вывод приведённого примера будет похож на:
array(2) {
["key1"]=>
string(6) "value1"
["key3"]=>
string(6) "value3"
}
Пример #2 Пример использования Memcached::getMulti() версий 1 и 2
<?php
// Работает с версиями модуля 1 и 2
$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)
}
Пример #3 Пример использования Memcached::GET_PRESERVE_ORDER с версией 3
<?php
// Работает с версией модуля 3
$m = new Memcached();
$m->addServer('localhost', 11211);
$data = array(
'foo' => 'foo-data',
'bar' => 'bar-data',
'baz' => 'baz-data',
'lol' => 'lol-data',
'kek' => 'kek-data',
);
$m->setMulti($data, 3600);
$keys = array_keys($data);
$keys[] = 'zoo';
$got = $m->getMulti($keys, Memcached::GET_PRESERVE_ORDER);
foreach ($got as $k => $v) {
echo "$k $v\n";
}
?>Вывод приведённого примера будет похож на:
foo foo-data bar bar-data baz baz-data lol lol-data kek kek-data zoo
Пример #4 Пример использования Memcached::GET_PRESERVE_ORDER с версией 1 и 2
<?php
// Работает с версиями модуля 1 и 2
$m = new Memcached();
$m->addServer('localhost', 11211);
$data = array(
'foo' => 'foo-data',
'bar' => 'bar-data',
'baz' => 'baz-data',
'lol' => 'lol-data',
'kek' => 'kek-data',
);
$m->setMulti($data, 3600);
$null = null;
$keys = array_keys($data);
$keys[] = 'zoo';
$got = $m->getMulti($keys, $null, Memcached::GET_PRESERVE_ORDER);
foreach ($got as $k => $v) {
echo "$k $v\n";
}
?>Вывод приведённого примера будет похож на:
foo foo-data bar bar-data baz baz-data lol lol-data kek kek-data zoo