Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKeyAlmacena un elemento en un servidor específico

Descripción

public 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 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.

key

La clave en la que se guardará el valor.

value

El valor a guardar.

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.

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