Memcache::set
(PECL memcache >= 0.2.0)
Memcache::set — Stocke des données dans le serveur de cache
Description
Memcache::set() stocke l'élément var
avec la clé key
sur le serveur de cache.
Le paramètre expire
représente le délai en secondes
d'expiration de l'élément. S'il vaut 0, l'élément n'expirera jamais (mais le serveur
de cache ne garantie pas que cet élément sera toujours stocké, il peut être
effacé du cache pour faire de la place à d'autres éléments).
Vous pouvez utiliser la constante MEMCACHE_COMPRESSED
comme valeur du paramètre flag
si vous voulez utiliser la compression à la volée (utilisation de la bibliothèque zlib).
Vous pouvez également utiliser la fonction memcache_set().Note:
Souvenez-vous que les ressources (i.e. identifiant de fichiers ou de connexion) ne peuvent pas être stockées dans le cache, car elles ne peuvent pas être représentées linéairement.
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 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 ou FALSE
si une erreur survient.
Exemples
Exemple #1 Exemple avec Memcache::set()
<?php /* API procédurale */ /* connexion au serveur de cache */ $memcache_obj = memcache_connect('memcache_host', 11211); /* définie la valeur de l'élément identifié par la clé 'var_key' ; utilisation de la valeur 0 pour le flag ; la compression n'est pas utilisée ; le délai d'expiration vaut 30 secondes */ memcache_set($memcache_obj, 'var_key', 'quelques variables', 0, 30); echo memcache_get($memcache_obj, 'var_key'); ?>
Exemple #2 Exemple avec Memcache::set()
<?php /* API orientée objet */ $memcache_obj = new Memcache; /* connexion au serveur de cache */ $memcache_obj->connect('memcache_host', 11211); /* définie la valeur de l'élément identifié par la clé 'var_key' ; utilisation de la compression à la volée ; le délai d'expiration vaut 50 secondes */ $memcache_obj->set('var_key', 'quelques grosses variables', MEMCACHE_COMPRESSED, 50); echo $memcache_obj->get('var_key'); ?>
Voir aussi
- Memcache::add() - Ajoute un élément dans le server
- Memcache::replace() - Remplace une valeur d'un élément existant