array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'memcache.set.php', 1 => 'Memcache::set', 2 => 'Stocke des données dans le serveur de cache', ), 'up' => array ( 0 => 'class.memcache.php', 1 => 'Memcache', ), 'prev' => array ( 0 => 'memcache.replace.php', 1 => 'Memcache::replace', ), 'next' => array ( 0 => 'memcache.setcompressthreshold.php', 1 => 'Memcache::setCompressThreshold', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/memcache/memcache/set.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcache::set

memcache_set

(PECL memcache >= 0.2.0)

Memcache::set -- memcache_set — Stocke des données dans le serveur de cache

Description

Memcache::set(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool
memcache_set(
    Memcache $memcache,
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool

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 garantit pas que cet élément sera toujours stocké, il peut être effacé du cache pour faire de la place à d'autres éléments). Il est possible d'utiliser la constante MEMCACHE_COMPRESSED comme valeur du paramètre flag pour utiliser la compression à la volée (utilisation de la bibliothèque zlib).

Note: Il faut se souvenir que les ressources (c.-à-d. 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
Utiliser MEMCACHE_COMPRESSED pour enregistrer l'élément compressé (utilise zlib).
expire
Temps d'expiration pour l'élément. S'il est égal à 0, l'élément n'expirera jamais. Il est également possible d'utiliser un timestamp Unix ou un nombre de secondes à partir du moment actuel, 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