Memcache::add
(PECL memcache >= 0.2.0)
Memcache::add — Ajoute un élément dans le server
Description
Memcache::add() stocke la variable
var
avec la clé key
seulement si cette clé
n'existe pas déja dans le serveur. La fonction memcache_add() exécute la
même action.
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 exceder 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éja. 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