Yac::add

(PECL yac >= 1.0.0)

Yac::add — Stocke une valeur sans écraser une valeur existante

Description

public function Yac::add(string|array $key, mixed $value, int $ttl = 0): bool

public function Yac::add(array $values, int $ttl = 0): bool

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.

Liste de paramètres

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.

Valeurs de retour

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é.

Exemples

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);
?>

Voir aussi

Yac::set() - Stocke une valeur dans le cache
Yac::get() - Récupère des valeurs du cache
Yac::delete() - Supprime des éléments du cache