(PECL apc >= 3.0.13)
apc_add — Met en cache une nouvelle variable dans le magasin de données
Met en cache une variable dans le magasin de données, uniquement si elle ne s'y trouve pas déjà.
Note: Contrairement aux autres mécanismes en PHP, les variables stockées en utilisant la fonction apc_add() seront persistantes entre les requêtes (jusqu'à ce que la valeur soit effacée du cache).
key
Stocke la variable en utilisant son nom. La clé key
est unique dans le cache, donc utilisez la fonction apc_add()
pour stocker une donnée avec une clé qui existe déjà n'efface pas la donnée
existante, mais retournera FALSE. (C'est la seule différence entre
la fonction apc_add() et la fonction apc_store().)
var
La variable à stocker
ttl
Durée de vie ; stocke la variable var dans le cache
pendant ttl secondes. Après ce délai, la variable
stockée sera effacée du cache (à la requête suivante). Si le
paramètre ttl n'est pas fourni (ou s'il vaut 0),
la valeur persistera tant qu'elle ne sera pas effacée manuellement du cache, ou si elle
n'existe plus dans le cache (effacement, redémarrage, etc.).
values
Les noms comme clés, les variables comme valeurs.
Retourne TRUE si quelque chose a bien été aujouté au cache,
FALSE sinon. La seconde syntaxe retourne un tableau avec les
clés en erreur.
Exemple #1 Exemple avec apc_add()
<?php
$bar = 'BAR';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
$bar = 'NEVER GETS SET';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
?>
L'exemple ci-dessus va afficher :
string(3) "BAR" string(3) "BAR"