Memcached::getMulti

(PECL memcached >= 0.1.0)

Memcached::getMulti — 检索多个项目

描述

public Memcached::getMulti(数组 $keys, 整数 $get_flags = 0): 数组|false

Memcached::getMulti() 类似于 Memcached::get()，但它不是检索单个键值项，而是检索多个项目，其键指定在 keys 数组中。

注意:
在 v3.0 之前，使用了第二个参数 &cas_tokens。它填充了找到的项目的 CAS 令牌值。&cas_tokens 参数已在扩展的 v3.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 v3 的 Memcached::getMulti() 示例

<?php
// 适用于扩展的 v3 版本

$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 v1 和 v2 的 Memcached::getMulti() 示例

<?php
// 适用于扩展的 v1 和 v2 版本

$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 v3 的 Memcached::GET_PRESERVE_ORDER 示例

<?php
// 此代码适用于扩展的v3版本

$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 Memcached v1 和 v2 版本示例

<?php
// 此代码适用于扩展的v1和v2版本

$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

参见

Memcached::getMultiByKey() - 从特定服务器检索多个项目
Memcached::get() - 检索一个项目
Memcached::getDelayed() - 请求多个项目

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 1 条注释

上移

下移

gabriel dot maybrun at demandmedia dot com ¶

10 年前

注意：最近我负责将 PECL memcache 迁移到 PECL memcached，并遇到一个重大问题——memcache 和 memcached 对数据的序列化方式不同，这意味着使用一个库写入的数据不一定能被另一个库读取。

例如，如果您使用 memcache 写入对象或数组，则 memcached 会将其解释为整数。如果您使用 memcached 写入它，则 memcache 会将其解释为字符串。

简而言之 -  如果不清除缓存或使用隔离的缓存环境，则不能安全地在 memcache 和 memcached 之间切换。

<?php
$memcache = new Memcache;
$memcacheD = new Memcached;
$memcache->addServer($host);
$memcacheD->addServers($servers);

$checks = array(
 123,
 4542.32,
 'a string',
 true,
 array(123, 'string'),
 (object)array('key1' => 'value1'),
);
foreach ($checks as $i => $value) {
 print "Checking WRITE with Memcache\n";
 $key = 'cachetest' . $i;
 $memcache->set($key, $value);
 usleep(100);
 $val = $memcache->get($key);
 $valD = $memcacheD->get($key);
 if ($val !== $valD) {
 print "Not compatible!";
 var_dump(compact('val', 'valD'));
 }

 print "Checking WRITE with MemcacheD\n";
 $key = 'cachetest' . $i;
 $memcacheD->set($key, $value);
 usleep(100);
 $val = $memcache->get($key);
 $valD = $memcacheD->get($key);
 if ($val !== $valD) {
 print "Not compatible!";
 var_dump(compact('val', 'valD'));
 }
}

＋添加注释