# Memcache::add

(PECL memcache >= 0.2.0)

Memcache::add — Añadir un valor en el servidor

### Descripción

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

Memcache::add() guarda la variable `var` con la clave `key` solamente si la clave no existe todavía en el servidor. También se puede usar la función memcache_add().

### Parámetros

`key`

  La clave que quedará asociada con el valor.

`var`

  La variable a guardar. Cadenas y enteros se guardan tal y como son, otros tipos se guardan serializados.

`flag`

  Use `MEMCACHE_COMPRESSED` para guardar datos comprimidos (usa zlib).

`expire`

  Tiempo de expiración del valor. Si es iqual a cero, el valor nunca expirará. También puedes usar Unix timestamp o el número de segundos empezando desde la fecha actual, el valor no puede exceder de 2592000 segundos (30 días).

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error. Devuelve `false` si la clave ya existe. Por el resto Memcache::add() se comporta similar a Memcache::set().

### Ejemplos

Ejemplo #1 Ejemplo Memcache::add()

`<?php
$memcache_obj = memcache_connect("localhost", 11211);
/* procedural API */
memcache_add($memcache_obj, 'var_key', 'test variable', false, 30);
/* OO API */
$memcache_obj->add('var_key', 'test variable', false, 30);
?>`

### Ver también

- Memcache::set() - Guarda datos en el servidor
- Memcache::replace() - Reemplaza el valor de un valor existente