(PECL wincache >= 1.1.0)
wincache_ucache_set — Ajoute une variable au cache utilisateur et écrase la variable si elle existe déjà dans le cache
Ajoute une variable au cache utilisateur. Écrase une variable si elle existe déjà dans le cache. La variable ainsi créée ou mise à jour restera dans le cache utilisateur tant que le délai d'expiration n'est pas atteint ou tant qu'elle n'est pas supprimée avec la fonction wincache_ucache_delete() ou la fonction wincache_ucache_clear().
key
Stocke la variable en utilisant la clé key.
Si une variable utilisant la même clé key est
déjà présente, la fonction écrasera la précédente valeur avec la nouvelle.
Le paramètre key est sensible à la casse.
key peut également être un tableau de paires
nom => valeur où les noms seront utilisés comme clés. Ceci peut être utile
pour ajouter plusieurs valeurs dans le cache en une seule opération.
value
Valeur de la variable à stocker. Le paramètre Value
supporte tous les types de données, sauf les ressources, comme les pointeurs
de fichiers. Ce paramètre est ignoré si le premier argument est un tableau.
Il est de convention de passer la valeur NULL comme valeur du paramètre
value lors de l'utilisation d'un tableau dans le paramètre
key. Si le paramètre value est un objet,
ou un tableau contenant des objets, alors tous les objets seront linéarisés.
Reportez-vous à la fonction __sleep()
pour plus de détails sur la linéarisation d'objets.
values
Tableau associatif de clés et de valeurs.
ttl
Durée de vie de la variable dans le cache, en secondes. Après la durée spécifiée par
le paramètre ttl, la variable stockée sera effacée du cache utilisateur.
Ce paramètre prend par défaut la valeur zéro (0), ce qui signifie
que la variable restera dans le cache tant qu'elle ne sera pas explicitement supprimée
en appelant la fonction wincache_ucache_delete() ou la fonction
wincache_ucache_clear().
Si key est une chaîne de caractères, la fonction retournera TRUE en cas de succès,
FALSE si une erreur survient.
Si key est un tableau, la fonction retournera :
FALSE.
Exemple #1 Exemple avec wincache_ucache_set() et
le paramètre key sous forme de chaîne de caractères
<?php
$bar = 'BAR';
var_dump(wincache_ucache_set('foo', $bar));
var_dump(wincache_ucache_get('foo'));
$bar1 = 'BAR1';
var_dump(wincache_ucache_set('foo', $bar1));
var_dump(wincache_ucache_get('foo'));
?>
L'exemple ci-dessus va afficher :
bool(true) string(3) "BAR" bool(true) string(3) "BAR1"
Exemple #2 Exemple avec wincache_ucache_set() et
le paramètre key sous forme de tableau
<?php
$colors_array = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_get('Blue'));
?>
L'exemple ci-dessus va afficher :
array(0) {}
array(0) {}
string(1) "6"