# Memcache::add

# memcache_add

(PECL memcache >= 0.2.0)

Memcache::add -- memcache_add — Ajoute un élément dans le server

### Description

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() stocke la variable `var` avec la clé `key` seulement si cette clé n'existe pas déjà dans le serveur.

### Liste de paramètres

`key`

  La clé à associer à l'élément.

`var`

  La variable à stocker. Les chaines et les entiers sont stockés tel quels, les autres types sont sérialisés.

`flag`

  Utilisez `MEMCACHE_COMPRESSED` pour compresser l'élément (utilise zlib).

`expire`

  Temps d'expiration de l'élément. Si égal à zéro, l'élément n'expirera jamais. Vous pouvez aussi utiliser un timestamp Unix ou un nombre de secondes partant du temps actuel, mais dans ce cas le nombre de secondes ne doit pas excéder 2592000 (30 jours).

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient. Retourne `false` si la clé existe déjà. Pour le reste, le comportement de Memcache::add() est le même que Memcache::set().

### Exemples

Exemple #1 Exemple avec 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);
?>`

### Voir aussi

- Memcache::set() - Stocke des données dans le serveur de cache
- Memcache::replace() - Remplace une valeur d'un élément existant