Yac::set

(PECL yac >= 1.0.0)

Yac::set — Stocke une valeur dans le cache

Description

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

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

Stocke une valeur dans le cache. Si la clé existe déjà, l'entrée existante est écrasée, qu'elle ait expiré ou non.

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.

Exemples

Exemple #1 Exemple avec Yac::set()

<?php
$yac = new Yac();

$yac->set("foo", "bar");                    // stocker une valeur unique
$yac->set("foo", "baz");                    // écraser l'entrée existante
?>

Exemple #2 Stockage d'une entrée avec un TTL

<?php
$yac = new Yac();

// ttl en secondes : l'entrée expire après 5 secondes
$yac->set("short-lived", "value", 5);
sleep(6);
var_dump($yac->get("short-lived"));        // bool(false): expiré
?>

Exemple #3 Stockage de plusieurs entrées en un appel

<?php
$yac = new Yac();

// stocker plusieurs paires clé => valeur en un appel
$yac->set(array("a" => 1, "b" => 2));
?>

Voir aussi

Yac::add() - Stocke une valeur sans écraser une valeur existante
Yac::get() - Récupère des valeurs du cache
Yac::__set() - Stocke une valeur via la syntaxe propriété