Manuel PHP
Précédent |  | Suivant

# Memcache::add

(no version information, might be only in CVS)

Memcache::add -- Ajout d'un élément au serveur

## Description

bool Memcache::add ( string key, mixed var [, int flag [, int expire]] )

Memcache::add() enregistre la variable var avec la clé key seulement si cette clé n'existe pas encore sur le serveur. Vous pouvez également utiliser la fonction Memcache_add().

## Liste de paramètres

key

  La clé qui sera associée avec l'élément.

var

  La variable à enregistrer. Les chaînes de caractères et les entiers sont enregistrés comme tels, les autres types sont enregistrés de manière sérialisée.

flag

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

expire

  Temps d'expiration pour l'élément. S'il égal 0, l'élément n'expirera jamais. Vous pouvez aussi utiliser un timestamp de unix ou un nombre de seconde en commençant par la date d'aujourd'hui, mais dans le dernier 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, `FALSE` en cas d'échec. Retourne `FALSE` si cette clé existe déjà. Pour le reste, la fonction Memcache::add() se comporte de façon similaire à la fonction Memcache::set().

## Exemples

Exemple 1. Exemple avec Memcache::add()
`<?php $memcache_obj = memcache_connect("localhost", 11211); /* API procédurale */ memcache_add($memcache_obj, 'var_key', 'test variable', false, 30); /* API orientée objet */ $memcache_obj->add('var_key', 'test variable', false, 30); ?>`

## Voir aussi

Memcache::set()
Memcache::replace()

Précédent | Sommaire | Suivant
Fonctions Memcache | Niveau supérieur | Memcache::addServer