PHP - Manual: Memcached::getMulti

2024-04-15

Memcached::getMultiByKey »

« Memcached::getDelayedByKey

Memcached::getMulti

(PECL memcached >= 0.1.0)

Memcached::getMulti — 检索多个元素

说明

public Memcached::getMulti(array $keys, int $flags = ?): mixed

Memcached::getMulti() 与 Memcached::get() 类似，但是这个方法用来检索 keys 数组指定的多个 key 对应的元素。

注意:
在 v3.0 之前，使用的第二个参数是 &cas_tokens。它会填充进元素的 CAS token 值。在本扩展里，&cas_tokens 参数在 v3.0 中已经移除。它被新的附加选项（flag） Memcached::GET_EXTENDED 代替，需要在 flags 值里使用。

flags参数可以用做指定Memcached::getMulti()的附加选项。当前，仅可以指定为Memcached::GET_PRESERVE_ORDER以保证返回的key的顺序和请求时一致。 Memcached::GET_EXTENDED 可以确保同时返回了 CAS token 信息。

参数

keys: 要检索的key的数组。
flags: Get 操作的附加选项。

返回值

返回检索到的元素的数组或者在失败时返回 false. 如需要则使用 Memcached::getResultCode()。

范例

示例 #1 Memcached::getMulti() 的 Memcached v3 示例


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


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


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

更新日志

版本	说明
3.0.0	移出参数 `&cas_tokens`。添加 `Memcached::GET_EXTENDED`，当需要获取 CAS token 信息时，传入 flag 中。

参见

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

add a note

User Contributed Notes 1 note

down

gabriel dot maybrun at demandmedia dot com ¶

7 years ago


GOTCHA: Recently I was tasked with moving from PECL memcache to PECL memcached and ran into a major problem -- memcache and memcached serialize data differently, meaning that data written with one library can't necessarily be read with the other library.

For example, If you write an object or an array with memcache, it's interpreted as an integer by memcached.  If you write it with memcached, it's interpreted as a string by memcache.

tl;dr - You can't safely switch between memcache and memcached without a either a cache flush or isolated cache environments.

<?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'));
    }
}

add a note

官方地址：https://www.php.net/manual/en/memcached.getmulti.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 科技开发编程 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL C/C++ 面试 Golang 数据库 Git 算法正则表达式操作系统 Redis 互联网 MySql JavaScript 运维软件架构设计 Mac OS TCP/IP 国际 Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子设计 nginx 娱乐摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 [PHP] inet_pton/inet_ntop IP地址转换函数 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 PHPMailer设置utf8 PHPMailer字符集CharSet 如何在Composer中为GitLab实例设置访问令牌 array_multisort() 多字段排序 laravel框架查看sql语句方式 [原创]诡异的php-fpm超时问题 PHP获取指定函数定义在哪个文件中及行号利用php soap实现web service php设置cookie为httponly防止xss攻击 PHP5 扩展SOAP 调用 webservice PHP-FPM进程数的设定利用PHP SOAP实现WEB SERVICE php上周一、本周一、下周一日期 PHPstorm 里面Terminal 不能使用 esc键吗退出编辑模式吗 PHP7添加redis扩展 PHP - mysql_real_escape_string()与mysql_escape_string() 的区别 Composer的Packagist资源

略微加速

PHP官方手册 - 互联网笔记

Memcached::getMulti

说明

参数

返回值

范例

更新日志

参见

User Contributed Notes 1 note