Almacena un elemento en un servidor específico

# Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKey — Almacena un elemento en un servidor específico

### Descripción

public function Memcached::setByKey(
string `$server_key`,
string `$key`,
mixed `$value`,
int `$expiration` = 0
): bool

Memcached::setByKey() es funcionalmente equivalente a Memcached::set(), excepto que la variable libre `server_key` puede ser utilizada para enviar la clave `key` a un servidor específico. Esto es útil si se desea agrupar ciertas claves en un servidor.

### Parámetros

`server_key`

  La clave que identifica el servidor donde almacenar o recuperar el valor. En lugar de calcular el hash sobre la clave real del elemento, se calcula el hash sobre la clave del servidor al decidir con qué servidor memcached comunicarse. Esto permite agrupar elementos relacionados en un solo servidor para mayor eficiencia con operaciones múltiples.

`key`

  La clave bajo la cual almacenar el valor.

`value`

  El valor a almacenar.

`expiration`

  El tiempo de expiración, predeterminado a 0. Véase Expiration Times para más información.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error. Utilice Memcached::getResultCode() si es necesario.

### Ejemplos

Ejemplo #1 Ejemplo con Memcached::setByKey()

    <?php
    $m = new Memcached();
    $m->addServer('localhost', 11211);

    /* Conserva los bloques de IP en un servidor */
    $m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
    $m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
    ?>

### Ver también

- Memcached::set() - Almacena un elemento

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open