Memcached::replaceByKey
(PECL memcached >= 0.1.0)
Memcached::replaceByKey — Reemplazar un ítem bajo una clave existente en un servidor específico
Descripción
$server_key
, string $key
, mixed $value
[, int $expiration
] )
La funcionalidad de Memcached::replaceByKey() es equivalente a
la de Memcached::replace(), 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.
Memcached::getResultCode() devolverá
Memcached::RES_NOTSTORED si la clave no existe.
Ver también
- Memcached::replace() - Reemplaza un ítem asociado a una clave existente
- Memcached::set() - Guardar un ítem
- Memcached::add() - Añade un ítem asociado a una nueva clave