Memcached::addByKey
(PECL memcached >= 0.1.0)
Memcached::addByKey — Añade un ítem asociado a una nueva clave en un servidor específico
Descripción
string
$server_key,string
$key,mixed
$value,int
$expiration = ?): bool
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.
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 ya existe.
Ver también
- Memcached::add() - Añade un ítem asociado a una nueva clave
- Memcached::set() - Guardar un ítem
- Memcached::replace() - Reemplaza un ítem asociado a una clave existente
add a note
