(PECL wincache >= 1.1.0)
wincache_ucache_add — Ajoute une nouvelle variable au cache utilisateur
Ajoute une variable au cache utilisateur, uniquement si elle n'existe pas déjà dans le cache. La variable restera dans le cache tant que le délai d'expiration n'est pas atteint ou qu'elle n'est effacée par la fonction wincache_ucache_delete() ou la fonction wincache_ucache_clear().
key
Stocke la variable en utilisant le nom key
. Si une variable
correspondant à la même clé est déjà présente dans le cache, la fonction
échouera et retournera false
. Le paramètre key
est sensible à la
casse. Pour écraser cette valeur, si key
est présent,
utilisez plutôt la fonction wincache_ucache_set().
key
peut également être un tableau de paires nom => valeur où
les noms seront utilisés comme clés. Ce format peut être utilisé pour ajouter
de multiples valeurs dans le cache en une seule opération.
value
La valeur de la variable à stocker. Le paramètre Value
supporte
tous les types de données, sauf les ressources, comme des pointeurs de fichiers.
Ce paramètre sera ignoré si le premier argument est un tableau. De façon général, il convient
de passer la valeur null
au paramètre value
lors de l'utilisation
d'un tableau pour le paramètre key
. Si le paramètre value
est un objet, ou un tableau contenant des objets, alors les objets seront sérialisés. Reportez-vous
à la fonction __sleep() pour plus de détails
sur la sérialisation 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 supprimée du cache. Ce paramètre prend, comme
valeur par défaut, zéro (0
), ce qui signifie que la variable restera dans le cache
tant qu'elle n'est pas explicitement effacée en utilisant la fonction wincache_ucache_delete()
ou la fonction wincache_ucache_clear().
Si le paramètre key
est une chaîne de caractères, la fonction retourne
true
en cas de succès, false
si une erreur survient.
Si le paramètre key
est un tableau, la fonction retourne :
false
;
Exemple #1 Exemple avec wincache_ucache_add() et le paramètre key
sous forme de chaîne de caractères
<?php
$bar = 'BAR';
var_dump(wincache_ucache_add('foo', $bar));
var_dump(wincache_ucache_add('foo', $bar));
var_dump(wincache_ucache_get('foo'));
?>
L'exemple ci-dessus va afficher :
bool(true) bool(false) string(3) "BAR"
Exemple #2 Exemple avec wincache_ucache_add() et le paramètre key
sous forme d'un tableau
<?php
$colors_array = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
var_dump(wincache_ucache_add($colors_array));
var_dump(wincache_ucache_add($colors_array));
var_dump(wincache_ucache_get('Blue'));
?>
L'exemple ci-dessus va afficher :
array(0) { } array(4) { ["green"]=> int(-1) ["Blue"]=> int(-1) ["yellow"]=> int(-1) ["cyan"]=> int(-1) } string(1) "6"