PHP Conference Japan 2024

    Memcached::getMulti

    (PECL memcached >= 0.1.0)

    Memcached::getMulti — 擷取多個項目

    說明

    public Memcached::getMulti(陣列 $keys, int $get_flags = 0): 陣列|false

    Memcached::getMulti() 的功能類似於 Memcached::get()，但它不是擷取單個鍵值，而是擷取多個鍵值，這些鍵值由 keys 陣列指定。

    注意事項:

    在 v3.0 之前，會使用第二個參數 &cas_tokens。它會被填入找到的項目的 CAS 權杖值。在擴充功能的 v3.0 中刪除了 &cas_tokens 參數。它被新的旗標 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

    另請參閱

    發現問題了嗎？

    瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤
    ＋新增註釋

    使用者貢獻的註釋 1 則註釋

    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     "使用 Memcache 檢查寫入\n";
    $key = 'cachetest' . $i;
    $memcache->set($key, $value);
    usleep(100);
    $val = $memcache->get($key);
    $valD = $memcacheD->get($key);
    if (    $val !== $valD) {
    print     "不相容!";
    var_dump(compact('val', 'valD'));
    }

    print     "使用 Memcached 檢查寫入\n";
    $key = 'cachetest' . $i;
    $memcacheD->set($key, $value);
    usleep(100);
    $val = $memcache->get($key);
    $valD = $memcacheD->get($key);
    if (    $val !== $valD) {
    print     "不相容!";
    var_dump(compact('val', 'valD'));
    }
    }
    ＋新增註釋
    To Top