Map a key to a server

Memcached::getResultMessage
Memcached::getServerList
Memcached
PHP Manual

# Memcached::getServerByKey

(PECL memcached >= 0.1.0)

Memcached::getServerByKey — Map a key to a server

### Description

public array Memcached::getServerByKey ( string `$server_key` )

Memcached::getServerByKey() returns the server that would be selected by a particular `server_key` in all the Memcached::*ByKey() operations.

### Parameters

`server_key`

  The key identifying the server to store the value on.

### Return Values

Returns `TRUE` on success or `FALSE` on failure. Use Memcached::getResultCode if necessary.

### Examples

Example #1 Memcached::getServerByKey() example

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

The above example will output something similar to:

    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)
    }

Memcached::getResultMessage
Memcached::getServerList
Memcached
PHP Manual