Memcached::setByKey
(PECL memcached >= 0.1.0)
Memcached::setByKey — Guardar un ítem en un servidor específico
Descripción
$server_key
, string $key
, mixed $value
[, int $expiration
] )
La funcionalidad de Memcached::setByKey() es equivalente a
la de Memcached::set(), 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.
-
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 de Memcached::setByKey()
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
/* mantener los bloques de IP en un servidor determinado */
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>