array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'memcached.addbykey.php', 1 => 'Memcached::addByKey', 2 => 'Añade un elemento en un servidor designado', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.add.php', 1 => 'Memcached::add', ), 'next' => array ( 0 => 'memcached.addserver.php', 1 => 'Memcached::addServer', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/memcached/memcached/addbykey.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcached::addByKey

(PECL memcached >= 0.1.0)

Memcached::addByKey — Añade un elemento en un servidor designado

Descripción

public Memcached::addByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = 0
): bool

Memcached::addByKey() es funcionalmente equivalente a Memcached::add(), pero la variable libre server_key puede ser utilizada para dirigir la clave key a un servidor específico.

Parámetros

server_key

La clave que identifica el servidor donde almacenar o recuperar el valor. En lugar de calcular el hash sobre la clave real del elemento, se calcula el hash sobre la clave del servidor al decidir con qué servidor memcached comunicarse. Esto permite agrupar elementos relacionados en un solo servidor para mayor eficiencia con operaciones múltiples.

key

La clave bajo la cual almacenar el valor.

value

El valor a almacenar.

expiration

El tiempo de expiración, predeterminado a 0. Véase Expiration Times para más información.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error. El método Memcached::getResultCode() va devolver la constante Memcached::RES_NOTSTORED si la clave ya existe.

Ver también