PHP 8.4.1 Released!

    Memcached::getServerByKey

    (PECL memcached >= 0.1.0)

    Memcached::getServerByKey — キーとサーバーを関連付ける

    説明

    public Memcached::getServerByKey(string $server_key): array|false

    Memcached::getServerByKey() は、 Memcached::*ByKey() 系の操作で指定された server_key に対応するサーバーを返します。

    パラメータ

    server_key

    値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。

    戻り値

    成功した場合に配列を返します。この配列には host、 port そして weight の三つのキーが含まれます。 失敗した場合に false を返します 必要に応じて Memcached::getResultCode() を使用しましょう。

    例

    例1 Memcached::getServerByKey() の例

    <?php
    $m     = new Memcached();
    $m->addServers(array(
    array(    'mem1.domain.com', 11211, 40),
    array(    'mem2.domain.com', 11211, 40),
    array(    'mem3.domain.com', 11211, 20),
    ));

    $m->setOption(Memcached::OPT_LIBKETAMA_COMPATIBLE, true);

    var_dump($m->getServerByKey('user'));
    var_dump($m->getServerByKey('log'));
    var_dump($m->getServerByKey('ip'));
    ?>

    上の例の出力は、 たとえば以下のようになります。

    array(3) {
  ["host"]=>
  string(15) "mem3.domain.com"
  ["port"]=>
  int(11211)
  ["weight"]=>
  int(20)
}
array(3) {
  ["host"]=>
  string(15) "mem2.domain.com"
  ["port"]=>
  int(11211)
  ["weight"]=>
  int(40)
}
array(3) {
  ["host"]=>
  string(15) "mem2.domain.com"
  ["port"]=>
  int(11211)
  ["weight"]=>
  int(40)
}

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    4
    zhaoyong dot lc at gmail dot com
    11 years ago
    The parameter server_key is very confusing, it's not a server key for MemCached Server, but it's key,in key-value pair which you stored in server.

    <?php
    $m     = new Memcached;
    $m->addServers(array(
    array(    '127.0.0.1',11212),
    array(    '127.0.0.1',11211)
    ));
    for(    $i=0;$i<10;$i++){
    $key = 'key_'.$i;
    $m->add($key, 1);
    }
    for(    $i=0;$i<10;$i++) {
    $key = 'key_'.$i;
    $arr = $m->getServerByKey($key);
    echo (    $key.":\t".$arr['port']."\n");
    }
    ?>

    key_0: 11212
    key_1: 11211
    key_2: 11212
    key_3: 11212
    key_4: 11212
    key_5: 11211
    key_6: 11211
    key_7: 11212
    key_8: 11212
    key_9: 11211
    up
    1
    morphles
    8 years ago
    Just to clarify (as documentation of memcached, even for C lib, frankly is quite lacking), $server_key is hashed using same method as regular keys for values (I checked C source, as again docs......). So you should be able to see where set($key, $value) goes by using getServerByKey($key) with same key. This can be useful if one does not wish to bother with using/has no need to use *ByKey functions, but still want to know which servers are/should be used with regular keys, for implementing fallback or failure reporting.
    ＋add a note
    To Top