(PECL yac >= 1.0.0)
Yac::add — Stocke une valeur sans écraser une valeur existante
Stocke une valeur dans le cache. Contrairement à Yac::set(), cette méthode n'écrase pas une entrée existante encore valide ; le stockage est rejeté dans ce cas.
key
Une clé string, ou un array de paires
clé => valeur à stocker en un seul appel.
value
La valeur à stocker. Tout type PHP sauf resource peut
être stocké. Utilisé uniquement dans la forme à clé unique ; quand
key est un tableau, cet argument est le
ttl optionnel.
ttl
Durée de vie en secondes. 0 signifie que l'entrée
n'expire jamais dans le temps.
Retourne true en cas de succès, false en cas d'échec. Un stockage
est également rejeté (retournant false) quand la clé existe déjà et
n'a pas expiré.
Exemple #1 Exemple avec Yac::add()
<?php
$yac = new Yac();
var_dump($yac->add("foo", "bar")); // bool(true)
var_dump($yac->add("foo", "baz")); // bool(false): "foo" existe déjà
?>Exemple #2 Ajout d'une entrée avec un TTL
<?php
$yac = new Yac();
// ttl en secondes ; 0 (la valeur par défaut) signifie que l'entrée n'expire jamais
$yac->add("short-lived", "value", 5);
sleep(6);
var_dump($yac->get("short-lived")); // bool(false): expiré
?>Exemple #3 Ajout de plusieurs entrées en un appel
<?php
$yac = new Yac();
// stocker plusieurs paires clé => valeur en un appel, avec un ttl
$yac->add(array("a" => 1, "b" => 2), 60);
?>