Memcache::add

memcache_add

(PECL memcache >= 0.2.0)

Memcache::add -- memcache_addAñade un elemento en el servidor

Descripción

Memcache::add(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool
memcache_add(
    Memcache $memcache,
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool

Memcache::add() almacena la variable var con la clave key solo si esta clave no existe ya en el servidor.

Parámetros

key

La clave a asociar al elemento.

var

La variable a almacenar. Los strings y los integers se almacenan tal cual, los otros tipos se serializan.

flag

Utilice MEMCACHE_COMPRESSED para comprimir el elemento (utiliza zlib).

expire

Tiempo de expiración del elemento. Si es igual a cero, el elemento nunca expirará. También puede utilizarse un timestamp Unix o un número de segundos a partir del tiempo actual, pero en este caso el número de segundos no debe exceder 2592000 (30 días).

Valores devueltos

Devuelve true en caso de éxito o false en caso de error. Devuelve false si la clave ya existe. Para el resto, el comportamiento de Memcache::add() es el mismo que Memcache::set().

Ejemplos

Ejemplo #1 Ejemplo con Memcache::add()

<?php

$memcache_obj
= memcache_connect("localhost", 11211);

/* API procedimental */
memcache_add($memcache_obj, 'var_key', 'test variable', false, 30);

/* API orientada a objetos */
$memcache_obj->add('var_key', 'test variable', false, 30);

?>

Ver también