Memcached::getMulti

    (PECL memcached >= 0.1.0)

    Memcached::getMulti — 检索多个项目

    描述

    public Memcached::getMulti(array $keys, int $get_flags = 0): array|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 v1 和 v2 的 Memcached::GET_PRESERVE_ORDER 示例

    <?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

    另请参阅

    改进此页面

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

    用户贡献的注释 1 个注释

    赞
    踩
    1
    gabriel dot maybrun at demandmedia dot com
    9 年前
    注意点：最近我被要求从 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'));
    }
    }
    ＋添加注释
    To Top