(PECL memcached >= 0.1.0)
Memcached::addByKey — Añade un ítem asociado a una nueva clave en un servidor específico
$server_key
, string $key
, mixed $value
[, int $expiration
] )
La funcionalidad de Memcached::addByKey() es equivalente a
la de Memcached::add(), 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.
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.
Devuelve TRUE
en caso de éxito o FALSE
en caso de error.
Memcached::getResultCode() devolverá
Memcached::RES_NOTSTORED
si la clave ya existe.