# Memcached::setMultiByKey

(PECL memcached >= 0.1.0)

Memcached::setMultiByKey — Almacena varios ítems en un servidor específico

### Descripción

public Memcached::setMultiByKey(string `$server_key`, array `$items`, int `$expiration` = ?): bool

La funcionalidad de Memcached::setMultiByKey() es equivalente a la de Memcached::setMulti(), con la excepción de que `server_key` se puede utilizar para que la clave dada por `key` corresponda a un servidor específico. Es útil si se necesita relacionar cierta cantidad de claves a un servidor determinado.

### Parámetros

`server_key`

  La clave que identifica al servidor donde guardar o recuperar el valor. En lugar de realizar un hash en la clave real para el ítem, se realiza en la clave del servidor cuando se decide con qué servidor de memcached conversar. Esto permite que los ítems relacionados sean agrupados en un único servidor para una mayor eficacia con operaciones múltiples.

`items`

  Un array de pares de clave/valor a almacenar en el servidor.

`expiration`

  Tiempo de expiración, que por defecto es 0. Ver Tiempos de expiración para más información.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error. Emplee Memcached::getResultCode() si fuera necesario.

### Ver también

- Memcached::setMulti() - Almacenar varios ítems
- Memcached::set() - Guardar un ítem